.hide()

类别：效果 > 基本

.hide()返回类型：jQuery

描述：隐藏匹配的元素。

  • 增补版本：1.0.hide()

    • 此签名没有任何参数。

  • 增补版本：1.0.hide( [duration ] [, complete ] )

    • duration (默认值： 400)
      类型：Number or String
      一个字符串或数字，决定了动画将运行多长时间。
    • complete
      类型：Function()
      每当动画完成时要调用的函数，针对每个匹配的元素调用一次。

  • 增补版本：1.0.hide( options )

    • options
      类型：PlainObject
      要传递给此方法的额外选项的映射。
      • duration (默认值： 400)
        类型：Number or String
        一个字符串或数字，决定了动画将运行多长时间。
      • easing (默认值： swing)
        类型：String
        一个字符串，指示要对过渡所用的渐进函数。
      • queue (默认值： true)
        类型：Boolean or String
        一个布尔值，指示是否要把动画放到效果队列中。如果是false，它会立即开始。自从jQuery 1.7以来，队列选择也可以接受一个字符串，它导致动画可以添加到用字符串表示的队列中。如果队列名所用的动画还没有自动开始，你必须调用.dequeue("queuename")来启动它。
      • specialEasing
        类型：PlainObject
        一个对象，包含了一个或多个CSS属性，则属性参数和它们对应的渐进函数定义。 (增补版本：1.4)
      • step
        类型：Function( Number now, Tween tween )
        一个函数，针对每个变动的元素的每个变动属性调用此函数。此函数为修改补间对象提供了机会，以在设置属性值之前先修改此属性值。
      • progress
        类型：Function( Promise animation, Number progress, Number remainingMs )
        在动画的每一步骤后面要调用的函数，无论变动的属性的数目是多少，对每个变动的元素只执行一次。 (增补版本：1.8)
      • complete
        类型：Function()
        一个函数，每当动画在一个元素上结束时，就调用它一次。
      • start
        类型：Function( Promise animation )
        当动画在一个元素上开始时要调用的函数。 (增补版本：1.8)
      • done
        类型：Function( Promise animation, Boolean jumpedToEnd )
        当动画在一个元素上完成时要调用的函数（它的应答对象已被解决）。 (增补版本：1.8)
      • fail
        类型：Function( Promise animation, Boolean jumpedToEnd )
        当某个元素上的动画失败而完成了的时候（它的应答对象被拒绝了）要调用的函数。 (增补版本：1.8)
      • always
        类型：Function( Promise animation, Boolean jumpedToEnd )
        当某对象上的动画完成，或未完成就停止了的时候（它的应答对象要么被解决了要么被拒绝了）要调用的函数。 (增补版本：1.8)

  • 增补版本：1.4.3.hide( duration [, easing ] [, complete ] )

    • duration (默认值： 400)
      类型：Number or String
      一个字符串或数字，决定了动画将运行多长时间。
    • easing (默认值： swing)
      类型：String
      一个字符串，指示要对过渡所用的渐进函数。
    • complete
      类型：Function()
      每当动画完成时要调用的函数，针对每个匹配的元素调用一次。

如果不带参数，.hide()方法就是隐藏一个元素的最简单方式。

1
 
$( ".target" ).hide();

匹配的元素将立即被隐藏。这基本等同于调用.css( "display", "none" )，除了display属性的值会被保存在jQuery的数据缓存中，从而display之后可以被恢复为它的初始值。如果一个元素具有display : inline，并隐藏然后显示，再次显示时，将显示为display : inline。

在持续过程中，如果提供一个扁平对象，或者一个“完成的函数”，.hide()就变成了一个动画方法。.hide()方法同步地变动了匹配的元素的宽度、高度和不透明度。如果这些属性达到0，则display样式属性被设置为none以确保元素不再影响网页的布局。

持续时间用毫秒给出；更高的值指示更慢的动画，而不是更快的动画。字符串'fast'和'slow'分别指示200毫秒和600毫秒的持续时间。

请注意，如果没有持续时间，或指定了持续时间为0，则.hide()会立即引发，并覆盖动画队列。

自从jQuery 1.4.3以来，可以使用一个可选的字符串，它命名了一个渐进函数。渐进函数指定了在动画内部，动画进程的不同点上的速率。jQuery库中仅有的渐进实现器是默认值，称为swing，以及以不变的速率前进的渐进实现器，称为linear。更多的渐进函数可以通过插件来实现，请注意jQuery UI套件。

如果提供了回调函数，它会在动画结束时引发一次。这可以用来把不同的动画串列在一个顺序中。回调函数不能发送任何参数，但是this被设置为被变动的DOM元素。如变动了多个元素，请注意回调函数是对每个匹配的元素执行一次，而不是针对整个动画执行一次。

注意：此方法可能导致性能问题，特别是在多个元素上使用时。如果你遭遇到这种情况，请使用性能测试工具来确定是否是该方法导致了问题。此外，如果显示值在不同的大小的视口有所不同，则此方法会导致响应性布局的问题。

我们可以变动任意元素，譬如变动一个图像：

1
2
3
4
 
<div id="clickme">
  Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123">
1
2
3
4
5
6
 
// With the element initially shown, we can hide it slowly:
$( "#clickme" ).click(function() {
  $( "#book" ).hide( "slow", function() {
    alert( "Animation complete." );
  });
});
插图 1 - 演示hide()效果

补充说明：

  • 所有的jQuery效果，包括.hide()，都可以通过全局地设置jQuery.fx.off = true来关闭，它有效地将持续时间设置为0。欲进一步了解，请参阅jQuery.fx.off。

示例：

在点击段落时隐藏所有段落。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
<!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 href="#">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毫秒内完成此动画。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 
<!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毫秒内完成每鼐劝画。一旦完成了动画，它就开始下一个。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
<!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>元素。请尝试一次点击不止一个盒子。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
<!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>

演示：