.show()
.show()
描述:显示匹配的元素。
该签名不接受任何参数。
- duration (默认值:
400)一个字符串或数字,用来确定动画运行多长时间。 - complete类型:Function()一个函数,在动画一旦结束时调用它,对每个匹配的元素调用一次。
- options类型:PlainObject传递给该方法的一个额外选项的映射。
- duration (默认值:
400)一个字符串或数字,用来确定动画运行多长时间。 - easing (默认值:
swing)类型:String一个字符串,标明为过渡使用哪种缓动函数。 - queue (默认值:
true)一个布尔值,标明是否要把动画放到效果队列中。如果是false,动画将立即开始。自从jQuery 1.7,queue选项可以接受一个字符串,那样的话,动画将加到以那个字符串代表的队列中。如果使用了一个自定义队列名,动画不会自动开始;你必须调用.dequeue("queuename")来启动它。 - specialEasing类型:PlainObject一个对象,包含了一个或更多的用属性参数和它们对应的缓动函数定义的CSS属性。(加入于1.4)
- step一个函数,每个变动的元素的每个变动的CSS属性都会调用它。这个函数提供了一个改变Tween对象的机会,可以在该属性被设置之前改变该属性的值。
- progress一个函数,在每个动画阶结束时调用它,只对每个变动的元素调用一次,无论有多少个变动的属性。(加入于1.8)
- complete类型:Function()一个函数,在动画一旦结束时调用它。
- start一个函数,每个元素上的动画开始时都会调用它一次。(加入于1.8)
- done一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被解决了)。(加入于1.8)
- fail一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被拒绝了)。(加入于1.8)
- always一个函数,在某个元素上的动画,或者在没结束时停止的时候(该元素的Promise对象要么是被解决要么是被拒绝)调用它。(加入于1.8)
如果不带参数,.show()方法是显示一个元素的最简单的方式:
$( ".target" ).show();
匹配的元素会立即显露出来,不带有动画。这基本等同于调用.css( "display", "block"),除了display属性是被恢复为它初始化时的该属性时。如果一个元素具有一个CSS属性display: inline;,然后被隐藏并再度显示,它最终会内联地显示文本。
注意:如果在你的样式表中使用了!important,比如说display: none !important,就有必要使用.css( "display", "block !important")来覆盖它,如果你想让它正确地显示出来的话。
如果向duration参数提供了一个纯对象,或者一个"complete"函数,.show()方法会变成一个动画方法。.show()方法同时地变动匹配的元素的宽度、高度和不透明度。
持续时间用毫秒数指定;更大的数字表示更慢的动画,而不是更快的动画。字符串'fast'表示200毫秒的持续时间,'slow'表示800毫秒的持续时间。
自从jQuery 1.4.3,可以使用一个可选的字符串,它命名了一个缓动函数。缓动函数指定了在动画过程内不同的时点上动画推进的速度。在jQuery库内只有两个缓动实现器,一个是默认情况下,称为swing,另一个是以恒定的节奏推进,称为linear。更多的缓动函数要用插件才能使用,特别是使用jQuery UI suite插件。
如果提供了,一旦动画结束时,会引发回调函数。这可以用来将不同的动画串成一个事件序列。回调函数并不发送任何参数,但是this被设置为执行动画的DOM元素。如果变动了多个元素,需要注意:回调函数会在每个匹配的元素上各执行一次,不是针对整个动画执行一次。
注意:该方法可能导致性能问题,特别是用在很多元素上时。如果你遭遇了这种问题,请使用性能测试工具以确定是不是这个方法导致了问题。此外,如果显示值在不同的视口有不同的值,这种方法可能会导致与响应的布局有关的问题。
我们可以变动任何元素,比如说一个图像:
<div id="clickme">
Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123">
With the element initially hidden, we can show it slowly:
$( "#clickme" ).click(function() {
$( "#book" ).show( "slow", function() {
// 动画完成。
});
});




其它说明
- 所有的动画效果,包括
.show()可以全局性地关闭,只要设置jQuery.fx.off=true,它会有效地把duration设置为0。要了解更多关于它的信息,参见jQuery.fx.off。
示例
变动所有的隐藏的段落文本,慢慢显示它们,在600毫秒内结束动画。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>show demo</title>
<style>
p {
background: yellow;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>Show it</button>
<p style="display: none">Hello 2</p>
<script>
$( "button" ).click(function() {
$( "p" ).show( "slow" );
});
</script>
</body>
</html>
演示结果
用200毫秒显示第一个div,后面依次跟着每个相邻的下一个同辈div。每个动画开始于上一个同辈div的动画结束时。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>show demo</title>
<style>
div {
background: #def3ca;
margin: 3px;
width: 80px;
display: none;
float: left;
text-align: center;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button id="showr">Show</button>
<button id="hidr">Hide</button>
<div>Hello 3,</div>
<div>how</div>
<div>are</div>
<div>you?</div>
<script>
$( "#showr" ).click(function() {
$( "div" ).first().show( "fast", function showNext() {
$( this ).next( "div" ).show( "fast", showNext );
});
});
$( "#hidr" ).click(function() {
$( "div" ).hide( 1000 );
});
</script>
</body>
</html>
演示结果
在一个动画中显示所有的<span>和<input>。一旦动画完成时就改变文本。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>show demo</title>
<style>
span {
display: none;
}
div {
display: none;
}
p {
font-weight: bold;
background-color: #fcd;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>Do it!</button>
<span>Are you sure? (type 'yes' if you are) </span>
<div>
<form>
<input type="text" value="as;ldkfjalsdf">
</form>
</div>
<p style="display:none;">I'm hidden...</p>
<script>
function doIt() {
$( "span,div" ).show( "slow" );
}
// 可以传入一个函数名
$( "button" ).click( doIt );
$( "form" ).submit(function( event ) {
if ( $( "input" ).val() === "yes" ) {
$( "p" ).show( 4000, function() {
$( this ).text( "Ok, DONE! (now showing)" );
});
}
$( "span,div" ).hide( "fast" );
// 防止表单提交
event.preventDefault();
});
</script>
</body>
</html>
演示结果