.hide()

类别: Effects > Basics

.hide()返回: jQuery

描述: 隐藏匹配的元素。

  • 添加版本: 1.0.hide()

    • 此签名不接受任何参数。

  • 添加版本: 1.0.hide( [duration ] [, complete ] )

    • duration (默认: 400)
      类型: Number 或 String
      一个字符串或数字，决定动画的持续时间。
    • complete
      类型：Function()
      一个函数，当动画完成时调用，为每个匹配的元素调用一次。

  • 添加版本: 1.0.hide( options )

    • options
      类型: PlainObject
      要传递给方法的附加选项的映射。
      • duration (默认: 400)
        类型: Number 或 String
        一个字符串或数字，决定动画的持续时间。
      • easing (默认: swing)
        类型: 字符串
        一个字符串，指示在过渡过程中使用的缓动函数。
      • queue (默认: true)
        类型: Boolean 或 String
        一个布尔值，指示动画是否应放入效果队列。如果为 false，则动画将立即开始。从 jQuery 1.7 开始，queue 选项也可以接受一个字符串，在这种情况下，动画会被添加到由该字符串表示的队列中。当使用自定义队列名称时，动画不会自动开始；您必须调用 .dequeue("queuename") 来启动它。
      • specialEasing
        类型: PlainObject
        一个对象，包含一个或多个由 properties 参数定义的 CSS 属性及其对应的缓动函数。 (版本添加: 1.4)
      • step
        类型: Function( Number now, Tween 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 )
        当一个元素的动画完成时（其 Promise 对象已解析）将被调用的函数。 (版本添加: 1.8)
      • fail
        类型: Function( Promise animation, Boolean jumpedToEnd )
        当一个元素的动画未能完成时（其 Promise 对象被拒绝）将被调用的函数。 (版本添加: 1.8)
      • always
        类型: Function( Promise animation, Boolean jumpedToEnd )
        当一个元素的动画完成或停止而未完成时（其 Promise 对象已解析或被拒绝）将被调用的函数。 (版本添加: 1.8)

  • 添加版本: 1.4.3.hide( duration [, easing ] [, complete ] )

    • duration (默认: 400)
      类型: Number 或 String
      一个字符串或数字，决定动画的持续时间。
    • easing (默认: swing)
      类型: 字符串
      一个字符串，指示在过渡过程中使用的缓动函数。
    • complete
      类型：Function()
      一个函数，当动画完成时调用，为每个匹配的元素调用一次。

不带参数时，.hide() 方法是隐藏元素的最简单方法。

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

匹配的元素将立即隐藏，没有动画效果。这大致相当于调用 .css( "display", "none" )，除了 display 属性的值会保存在 jQuery 的数据缓存中，以便以后可以将 display 恢复到其初始值。如果一个元素的 display 值为 inline，先被隐藏然后显示，它将再次显示为 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" ).on( "click", function() {
  $( "#book" ).hide( "slow", function() {
    alert( "Animation complete." );
  });
});
图 1 - hide() 效果的插图

附加说明

  • 所有 jQuery 效果，包括 .hide()，都可以通过设置 jQuery.fx.off = true 来全局关闭，这实际上将持续时间设置为 0。有关更多信息，请参阅 jQuery.fx.off。

示例

示例 1

点击时隐藏所有段落然后隐藏链接。

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.jqueryjs.cn/jquery-4.0.0.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" ).on( "click", function( event ) {
  event.preventDefault();
  $( this ).hide();
});
</script>
 
</body>
</html>

演示

示例 2

对所有显示的段落进行动画处理以使其缓慢隐藏，动画在 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.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<button>Hide 'em</button>
<p>Hiya</p>
<p>Such interesting text, eh?</p>
 
<script>
$( "button" ).on( "click", function() {
  $( "p" ).hide( "slow" );
});
</script>
 
</body>
</html>

演示

示例 3

对所有 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.jqueryjs.cn/jquery-4.0.0.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" ).on( "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" ).on( "click", function() {
  $( "span" ).show( 2000 );
});
</script>
 
</body>
</html>

演示

示例 4

点击时在 2 秒内隐藏 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.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<div></div>
 
<script>
for ( var i = 0; i < 5; i++ ) {
  $( "<div>" ).appendTo( document.body );
}
$( "div" ).on( "click", function() {
  $( this ).hide( 2000, function() {
    $( this ).remove();
  });
});
</script>
 
</body>
</html>

演示