基本效果
方法列表
方法 | 概述 |
---|---|
show() | 用于显示所有匹配的元素。此外,你还可以指定元素显示的过渡动画效果。 |
hide() | 用于隐藏显示的元素。此外,你还可以指定元素隐藏的过渡动画效果。 |
toggle() | 用于切换所有匹配的元素。此外,你还可以指定元素切换的过渡动画效果。 |
方法说明
show():
如果元素本身是可见的,则不对其作任何改变。如果元素是隐藏的,则使其可见。
与该函数相对的是hide()函数,用于隐藏所有匹配的元素。
语法 :
- .show( [ duration ] [, easing ] [, complete ] )
- .show( options )
用法2是用法1的变体。以对象形式指定所需的选项参数(可指定比用法1更多的选项参数)。
参数说明:
参数 | 描述 |
---|---|
duration | 可选/String/Number类型 指定过渡动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串”fast”(=200)或”slow”(=600)。 |
easing | 可选/String类型 指定使用何种动画效果,默认为”swing”,还可以设为”linear”或其他自定义的动画样式的函数名称。 |
complete | 可选/Function类型 元素显示完毕后需要执行的函数。函数内的this指向当前DOM元素。 |
options | Object类型 指定的选项参数对象。 |
如果没有为show()指定任何参数,则将以最快方式直接显示元素,不使用动画效果。
参数options对象可以识别如下的属性(以下属性均是可选的):
属性 | 属性描述 |
---|---|
duration | 参见参数duration。 |
easing | 参见参数easing。 |
complete | 参见参数complete。 |
queue | Boolean类型 指示是否将动画放入效果队列中,默认为true。从1.7版本开始,该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始,你需要手动调用dequeue(“queueName”)来启动队列。 |
此外,jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持,但这些参数并不常用
HTML代码
<select id="animation">
<option value="1">show( )</option>
<option value="2">show( "slow" )</option>
<option value="3">show( 3000 )</option>
<option value="4">show( 1000, complete )</option>
<option value="5">show( 1000, "linear" )</option>
<option value="6">show( options )</option>
</select>
<input id="btnShow" type="button" value="显示" /> <input id="btnHide" type="button" value="隐藏" />
JavaScript代码:
// 【显示】按钮
$("#btnShow").click( function(){
var v = $("#animation").val();
if( v == "1" ){
$("p").show( );
}else if(v == "2"){
$("p").show( "slow" );
}else if(v == "3"){
$("p").show( 3000 );
}else if(v == "4"){
$("p").show( 1000, function(){
alert("显示完毕!"); // 有两个p标签,会弹出两次
} );
}else if(v == "5"){
$("p").show( 1000, "linear" );
}else if(v == "6"){
$("p").show( { duration: 1000 } );
}
} );
// 【隐藏】按钮
$("#btnHide").click( function(){
$("p").hide( );
} );
hide():
如果元素本身是不可见的,则不对其作任何改变。如果元素是可见的,则将其隐藏。
与该函数相对的是show()函数,用于显示所有匹配的元素。
语法 :
- .hide( [ duration ] [, easing ] [, complete ] )
- .hide( options )
用法2是用法1的变体。以对象形式指定所需的选项参数(可指定比用法1更多的选项参数)。
参数说明:
参数 | 描述 |
---|---|
duration | 可选/String/Number类型 指定过渡动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串”fast”(=200)或”slow”(=600)。 |
easing | 可选/String类型 指定使用何种动画效果,默认为”swing”,还可以设为”linear”或其他自定义的动画样式的函数名称。 |
complete | 可选/Function类型 元素隐藏完毕后需要执行的函数。函数内的this指向当前DOM元素。 |
options | Object类型 指定的选项参数对象。 |
如果没有为show()指定任何参数,则将以最快方式直接显示元素,不使用动画效果。
参数options对象可以识别如下的属性(以下属性均是可选的):
属性 | 属性描述 |
---|---|
duration | 参见参数duration。 |
easing | 参见参数easing。 |
complete | 参见参数complete。 |
queue | Boolean类型 指示是否将动画放入效果队列中,默认为true。从1.7版本开始,该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始,你需要手动调用dequeue(“queueName”)来启动队列。 |
此外,jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持,但这些参数并不常用
HTML代码
<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="隐藏" />
JavaScript代码:
// 【显示】按钮
$("#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 } );
}
} );
toggle():
所谓”切换”,也就是如果元素当前是可见的,则将其隐藏;如果元素当前是隐藏的,则使其显示(可见)。
这里介绍的toggle()函数用于切换元素的显示/隐藏。jQuery还有一个同名的事件函数toggle(),用于绑定click事件并在触发时轮流切换执行不同的事件处理函数。
语法 :
- .toggle( [ duration ] [, easing ] [, complete ] )
- .toggle( options )
用法2是用法1的变体。以对象形式指定所需的选项参数(可指定比用法1更多的选项参数)。 - .toggle( showOrHide )
通过布尔值showOrHide来指定是显示还是隐藏元素。
参数说明:
参数 | 描述 |
---|---|
duration | 可选/String/Number类型 指定过渡动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串”fast”(=200)或”slow”(=600)。 |
easing | 可选/String类型 指定使用何种动画效果,默认为”swing”,还可以设为”linear”或其他自定义的动画样式的函数名称。 |
complete | 可选/Function类型 元素切换完毕后需要执行的函数。函数内的this指向当前DOM元素。 |
options | Object类型 指定的选项参数对象。 |
showOrHide | Boolean类型 指定显示/隐藏元素的布尔值。如果为true,就显示元素,否则隐藏元素。 |
如果没有为toggle()指定任何参数,则将以最快方式直接显示/隐藏元素,不使用动画效果
参数options对象可以识别如下的属性(以下属性均是可选的):
属性 | 属性描述 |
---|---|
duration | 参见参数duration。 |
easing | 参见参数easing。 |
complete | 参见参数complete。 |
queue | Boolean类型 指示是否将动画放入效果队列中,默认为true。从1.7版本开始,该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始,你需要手动调用dequeue(“queueName”)来启动队列。 |
此外,jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持,但这些参数并不常用
HTML代码
<select id="animation">
<option value="1">toggle( )</option>
<option value="2">toggle( "slow" )</option>
<option value="3">toggle( 3000 )</option>
<option value="4">toggle( 1000, complete )</option>
<option value="5">toggle( 1000, "linear" )</option>
<option value="6">toggle( options )</option>
<option value="7">toggle( true )</option>
<option value="8">toggle( false )</option>
</select>
<input id="btnSwitch" type="button" value="切换显示/隐藏" >
JavaScript代码:
//【切换显示/隐藏】按钮
$("#btnSwitch").click( function(){
var v = $("#animation").val();
if( v == "1" ){
$("p").toggle( );
}else if(v == "2"){
$("p").toggle( "slow" );
}else if(v == "3"){
$("p").toggle( 3000 );
}else if(v == "4"){
$("p").toggle( 1000, function(){
alert("切换完毕!");
} );
}else if(v == "5"){
$("p").toggle( 1000, "linear" );
}else if(v == "6"){
$("p").toggle( { duration: 1000 } );
}else if(v == "7"){
$("p").toggle( true ); // 相当于$("p").show();
}else if(v == "8"){
$("p").toggle( false ); // 相当于$("p").hide();
}
} );