返回值:jQueryshow()
显示匹配的元素。
-
1.0 新增show()
-
1.0 新增show(duration, [callback])
duration (String,Number) 字符串("slow"或 "fast")或表示动画时长的毫秒数值callback (Callback) 可选参数,在动画完成时执行的函数。 -
1.4.3 新增show([duration], [easing], [callback])
duration (String,Number) 可选参数,字符串("slow"或 "fast")或表示动画时长的毫秒数值easing (String) 可选参数,要使用的缓冲效果的名称,默认值是 "swing"。jQuery 内置提供 "linear" 和 "swing" 两种效果,如果要使用更多缓冲效果,需要插件支持。callback (Callback) 可选参数,在动画完成时执行的函数。
显示元素的最简单方式就是不带参数的 .show()
方法:
$('.target').show();
此时元素会立即显示起来,不带有任何动画。这基本等价于 .css('display', 'block')
,只不过此时 display
属性值会保存到 jQuery 的数据缓存中,之后还能恢复 display
的初始值。比如,如果一个元素的 display
值为 inline
,那么当隐藏再显示时,他仍然是 inline
。
如果提供 duration 参数,.show()
就变成一个动画方法了。.show()
会同时对元素的高、宽以及透明度进行动画操作。
duration 参数可以提供一个毫秒数,代表动画运行的时间,时间越长动画越慢。还可以提供字符串 'fast'
和 'slow'
,分别对应了 200
和 600
毫秒。如果没有设置 duration
参数,或者设置成其他无法识别的字符串,就会使用默认值 400 毫秒。
从 jQuery 1.4.3 起,增加了一个可选的参数,用于确定使用的缓冲函数。缓冲函数确定了动画在不同的位置的速度。jQuery默认只提供两个缓冲效果:swing
和 linear
。更多特效需要使用插件。可以访问 jQuery UI 网站 来获得更多信息。
如果提供了回调函数,那么当动画结束时,会调用这个函数。通常用来几个不同的动画依次完成。这个函数不接受任何参数,但是 this
会设成将要执行动画的那个元素。如果对多个元素设置动画,那么要非常注意,回调函数会在每一个动画完成的元素上都执行一次,而不是对这组动画整体才执行一次。
比如下面这个页面:
<div id="clickme"> Click here </div> <img id="book" src="book.png" alt="" width="100" height="123" />
如果元素一开始隐藏的,我们可以让他缓慢的显示出来:
$('#clickme').click(function() { $('#book').show('slow', function() { // 动画完毕 }); });
示例:
把所有隐藏的段落缓慢显现出来,用时 600 毫秒。
<!DOCTYPE html>
<html>
<head>
<style>
p { background:yellow; }
</style>
<script src="jquery.min.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>
演示:
示例:
把隐藏的 div 依次迅速显示出来,每个用时 200 毫秒。一个动画完成后立即开始下一个。
<!DOCTYPE html>
<html>
<head>
<style>
div { background:#def3ca; margin:3px; width:80px;
display:none; float:left; text-align:center; }
</style>
<script src="jquery.min.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:eq(0)").show("fast", function () {
/* use callee so don't have to name the function */
$(this).next("div").show("fast", arguments.callee);
});
});
$("#hidr").click(function () {
$("div").hide(2000);
});
</script>
</body>
</html>
演示:
示例:
动画显示所有 span 和 input 元素。可以试着在下面的文本框中输入 yes 并按回车。
<!DOCTYPE html>
<html>
<head>
<style>
span { display:none; }
div { display:none; }
p { font-weight:bold; background-color:#fcd; }
</style>
<script src="jquery.min.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");
}
/* can pass in function name */
$("button").click(doIt);
$("form").submit(function () {
if ($("input").val() == "yes") {
$("p").show(4000, function () {
$(this).text("Ok, DONE! (now showing)");
});
}
$("span,div").hide("fast");
/* to stop the submit */
return false;
});
</script>
</body>
</html>