.hide()
.hide()
描述:隐藏匹配的元素。
该签名不接受任何参数。
- 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)
如果不带参数,.hide()
方法是隐藏一个元素的最简单的方式:
$( ".target" ).hide();
被匹配的元素将不带动画地立即隐藏。这大致地等同于.css( "display", "none" )
,除了display
属性的值是保存在jQuery的数据缓存中,所以display
之后可以保存成它的初始值。如果一个元素的display
值是inline
,然后隐藏,再显示它,它依然会显示为display:inline
。
如果提供了一个duration、一个纯对象,或者提供了一个complete回调函数,.hide()
方法就变成了一个动画方法。.hide()
方法同时地变动了匹配的元素宽度、高度以及不透明度。当这些值到达0时,display
样式属性会被设置为none
以确保元素不会影响网页的布局。
持续时间用毫秒数指定;更大的数字表示更慢的动画,而不是更快的动画。字符串'fast'
表示200
毫秒的持续时间,'slow'
表示800
毫秒的持续时间。
注意:如果没有持续时间,或者duration被指定为0,.hide()
会立即引发,并覆盖动画队列。
自从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 shown, we can hide it slowly: $( "#clickme" ).click(function() { $( "#book" ).hide( "slow", function() { alert( "Animation complete." ); }); });
其它说明
- 所有的动画效果,包括
.hide()
可以全局性地关闭,只要设置jQuery.fx.off=true
,它会有效地把duration设置为0。要了解更多关于它的信息,参见jQuery.fx.off。
示例
在点击链接后隐藏所有的段落文本。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>hide demo</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <p>Hello</p> <a >Click to hide me too</a> <p>Here is another paragraph</p> <script> $( "p" ).hide(); $( "a" ).click(function( event ) { event.preventDefault(); $( this ).hide(); }); </script> </body> </html>
演示结果
变动所有显示的段落文本以慢慢地隐藏它,在600毫秒内完成动画。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>hide demo</title> <style> p { background: #dad; font-weight: bold; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>Hide 'em</button> <p>Hiya</p> <p>Such interesting text, eh?</p> <script> $( "button" ).click(function() { $( "p" ).hide( "slow" ); }); </script> </body> </html>
演示结果
快速变动所有的<span>使它们隐藏,在200毫秒内完成每个动画。一旦有一个动完成成了,它会开始下一个动画。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>hide demo</title> <style> span { background: #def3ca; padding: 3px; float: left; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button id="hider">Hide</button> <button id="shower">Show</button> <div> <span>Once</span> <span>upon</span> <span>a</span> <span>time</span> <span>there</span> <span>were</span> <span>three</span> <span>programmers...</span> </div> <script> $( "#hider" ).click(function() { $( "span:last-child" ).hide( "fast", function() { // Use arguments.callee so we don't need a named function $( this ).prev().hide( "fast", arguments.callee ); }); }); $( "#shower" ).click(function() { $( "span" ).show( 2000 ); }); </script> </body> </html>
演示结果
在点击div两秒之后隐藏该div,然后在它隐藏时删除该div元素。试一试在同时多个div上点击。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>hide demo</title> <style> div { background: #ece023; width: 30px; height: 40px; margin: 2px; float: left; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div></div> <script> for ( var i = 0; i < 5; i++ ) { $( "<div>" ).appendTo( document.body ); } $( "div" ).click(function() { $( this ).hide( 2000, function() { $( this ).remove(); }); }); </script> </body> </html>
演示结果