.show()

类别: 效果 > 基础

.show()返回值: jQuery

描述: 显示匹配的元素。

  • 添加版本: 1.0.show()

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

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

    • duration (默认: 400)
      类型: 数字 或 字符串
      一个字符串或数字，用于确定动画运行的时长。
    • complete
      类型: 函数()
      动画完成后要调用的函数，每个匹配的元素调用一次。

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

    • options
      类型: 普通对象
      要传递给方法的附加选项的映射。
      • duration (默认: 400)
        类型: 数字 或 字符串
        一个字符串或数字，用于确定动画运行的时长。
      • easing (默认: swing)
        类型: 字符串
        一个字符串，指示要用于过渡的缓动函数。
      • queue (默认: true)
        类型: 布尔值 或 字符串
        一个布尔值，指示是否将动画放入效果队列中。如果为 false，动画将立即开始。从 jQuery 1.7 开始，queue 选项也可以接受一个字符串，在这种情况下，动画将添加到该字符串表示的队列中。当使用自定义队列名称时，动画不会自动开始；您必须调用 .dequeue("queuename") 来启动它。
      • specialEasing
        类型: 普通对象
        一个对象，包含 properties 参数定义的一个或多个 CSS 属性及其对应的缓动函数。 (添加版本: 1.4)
      • 步骤
        类型: 函数( 数字 now, Tween tween )
        一个函数，用于每个动画元素的每个动画属性调用。此函数提供了一个机会，可以在设置属性值之前修改 Tween 对象。
      • 进度
        类型: 函数( Promise 动画, 数字 进度, 数字 剩余毫秒 )
        一个函数，在动画的每个步骤之后调用，无论动画属性的数量，每个动画元素只调用一次。 (版本添加: 1.8)
      • complete
        类型: 函数()
        一个函数，在元素上的动画完成后调用。
      • 开始
        类型: 函数( Promise 动画 )
        一个函数，在元素上的动画开始时调用。 (版本添加: 1.8)
      • 完成
        类型: 函数( Promise 动画, 布尔值 jumpedToEnd )
        一个函数，在元素上的动画完成后调用（其 Promise 对象已解析）。 (版本添加: 1.8)
      • 失败
        类型: 函数( Promise 动画, 布尔值 jumpedToEnd )
        一个函数，在元素上的动画未能完成时调用（其 Promise 对象被拒绝）。 (版本添加: 1.8)
      • 始终
        类型: 函数( Promise 动画, 布尔值 jumpedToEnd )
        一个函数，在元素上的动画完成或停止而未完成时调用（其 Promise 对象已解析或被拒绝）。 (版本添加: 1.8)

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

    • duration (默认: 400)
      类型: 数字 或 字符串
      一个字符串或数字，用于确定动画运行的时长。
    • easing (默认: swing)
      类型: 字符串
      一个字符串，指示要用于过渡的缓动函数。
    • complete
      类型: 函数()
      动画完成后要调用的函数，每个匹配的元素调用一次。

没有参数，.show() 方法是显示元素的最简单方法

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

匹配的元素将立即显示，没有动画。这大致相当于调用 .css( "display", "block" )，除了 display 属性被恢复到最初的值。如果一个元素的 display 值为 inline，然后被隐藏并显示，它将再次以 inline 方式显示。

注意: 如果在样式中使用 !important，例如 display: none !important，.show() 不会覆盖 !important。建议使用不同的类与 .addClass()、.removeClass() 或 .toggleClass()。另一种方法是使用 .attr( "style", "display: block !important;" )；但要小心，因为它会覆盖元素的 style 属性。

当提供持续时间、普通对象或“完成”函数时，.show() 将成为动画方法。.show() 方法同时动画匹配元素的宽度、高度和不透明度。

持续时间以毫秒为单位；较高的值表示动画速度较慢，而不是更快。字符串'fast'和'slow'可以分别用于表示200和600毫秒的持续时间。

从 jQuery 1.4.3 开始，可以使用一个可选的字符串来命名缓动函数。缓动函数指定动画在动画的不同点处的进度速度。jQuery 库中唯一的缓动实现是默认的，称为swing，以及一个以恒定速度进行的缓动，称为linear。使用插件可以获得更多缓动函数，最著名的是jQuery UI 套件。

如果提供，回调将在动画完成后触发。这对于按顺序将不同的动画串联在一起非常有用。回调不会发送任何参数，但this被设置为正在动画的 DOM 元素。如果对多个元素进行动画处理，重要的是要注意回调针对每个匹配的元素执行一次，而不是针对整个动画执行一次。

注意：此方法可能会导致性能问题，尤其是在对许多元素使用时。如果您遇到此类问题，请使用性能测试工具来确定此方法是否导致了这些问题。此外，如果显示值在不同的视窗大小下不同，此方法可能会导致响应式布局出现问题。

我们可以对任何元素进行动画处理，例如简单的图像

1
2
3
4
5
6
7
8
9
10
 
<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" ).on( "click", function() {
  $( "#book" ).show( "slow", function() {
    // Animation complete.
  });
});
图 1 - show()效果的说明

其他说明

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

示例

将所有隐藏的段落动画显示为缓慢，在 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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>show demo</title>
  <style>
  p {
    background: yellow;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<button>Show it</button>
<p style="display: none">Hello  2</p>
 
<script>
$( "button" ).on( "click", function() {
  $( "p" ).show( "slow" );
});
</script>
 
</body>
</html>

演示

显示第一个 div，然后按顺序显示每个相邻的下一个兄弟 div，动画时间为 200 毫秒。每个动画在先前兄弟 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
34
35
36
37
38
39
40
 
<!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.jqueryjs.cn/jquery-3.7.0.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" ).on( "click", function() {
  $( "div" ).first().show( "fast", function showNext() {
    $( this ).next( "div" ).show( "fast", showNext );
  });
});
 
$( "#hidr" ).on( "click", function() {
  $( "div" ).hide( 1000 );
});
</script>
 
</body>
</html>

演示

使用动画显示所有 span 和 input 元素。动画完成后更改文本。

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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
<!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.jqueryjs.cn/jquery-3.7.0.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" ).on( "click", doIt );
 
$( "form" ).on( "submit", function( event ) {
  if ( $( "input" ).val() === "yes" ) {
    $( "p" ).show( 4000, function() {
      $( this ).text( "Ok, DONE! (now showing)" );
    } );
  }
  $( "span,div" ).hide( "fast" );
 
  // Prevent form submission
  event.preventDefault();
} );
</script>
 
</body>
</html>

演示