
注: 以下函数用法和hide()类似 [参数类型完全一样]
toggle()
hide()
show()
slideToggle()
slideUp()
slideDown()
fadeToggle()
fadeOut()
fadeIn()
jQuery.hide() 函数详解
hide()
函数用于隐藏所有匹配的元素。此外,你还可以指定元素隐藏的过渡动画效果。如果元素本身是不可见的,则不对其作任何改变。如果元素是可见的,则将其隐藏。
与该函数相对的是show()函数,用于显示所有匹配的元素。
该函数属于jQuery
对象(实例)。
语法
jQuery 1.0 新增该函数。hide()
函数主要有以下两种形式的用法:
用法一:jQuery 1.4.3 新增支持参数easing
。
jQueryObject.hide( [ duration ] [, easing ] [, complete ] )
用法二:
jQueryObject.hide( options )
用法二是用法一的变体。以对象形式指定所需的选项参数(可指定比用法一更多的选项参数)。
参数
参数 | 描述 |
---|---|
duration |
可选/String/Number类型指定过渡动画运行多长时间(毫秒数),默认值为400。 该参数也可以为字符串"fast"(=200)或"slow"(=600)。 |
easing |
可选/String类型指定使用何种动画效果,默认为"swing",还可以设为"linear"或 其他自定义的动画样式的函数名称。 swing:摆动效果(秋千),两边慢,中间快。linear: 线性 |
complete | 可选/Function类型元素隐藏完毕后需要执行的函数。函数内的this 指向当前DOM元素。 |
options | Object类型指定的选项参数对象。 |
如果没有为hide()
指定任何参数,则将以最快方式直接隐藏元素,不使用动画效果。
参数options
对象可以识别如下的属性(以下属性均是可选的):
属性 | 属性描述 |
---|---|
duration | 参见参数duration 。 |
easing | 参见参数easing 。 |
complete | 参见参数complete 。 |
queue |
Boolean类型指示是否将动画放入效果队列中,默认为 该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始, 你需要手动调用dequeue("queueName")来启动队列。 |
此外,jQuery 1.4 和 1.8 还为参数options
新增了许多新的选项支持,但这些参数并不常用,此处不再赘述,详见jQuery官方文档。
返回值
hide()
函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
请参考下面这段初始HTML代码:
<p>CodePlayer</p><p>专注于编程开发技术分享</p>隐藏效果:<select id="animation"> <option value="1">hide( )</option> <option value="2">hide( "slow" )</option> <option value="3">hide( 3000 )</option> <option value="4">hide( 1000, complete )</option> <option value="5">hide( 1000, "linear" )</option> <option value="6">hide( options )</option></select><input id="btnShow" type="button" value="显示" /><input id="btnHide" type="button" value="隐藏" />
以下是与hide()
函数相关的jQuery示例代码,以演示hide()
函数的具体用法:
// 【显示】按钮$("#btnShow").click( function(){ $("p").show( );} ); //【隐藏】按钮$("#btnHide").click( function(){ var v = $("#animation").val(); if( v == "1" ){ $("p").hide( ); }else if(v == "2"){ $("p").hide( "slow" ); }else if(v == "3"){ $("p").hide( 3000 ); }else if(v == "4"){ $("p").hide( 1000, function(){ alert("隐藏完毕!"); } ); }else if(v == "5"){ $("p").hide( 1000, "linear" ); }else if(v == "6"){ $("p").hide( { duration: 1000 } ); }} );