.show() | jQuery中文网 | jQuery API 中文文档

.show()返回类型：jQuery

描述：显示匹配的元素。

增补版本：1.0.show()
- 此签名没有任何参数。
增补版本：1.0.show( [duration ] [, complete ] )
- duration (默认值： 400)
  
  类型：Number or String
  
  一个字符串或数字，决定了动画将运行多长时间。
- complete
  
  类型：Function()
  
  每当动画完成时要调用的函数，针对每个匹配的元素调用一次。
增补版本：1.0.show( 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.show( duration [, easing ] [, complete ] )
- duration (默认值： 400)
  
  类型：Number or String
  
  一个字符串或数字，决定了动画将运行多长时间。
- easing (默认值： swing)
  
  类型：String
  
  一个字符串，指示要对过渡所用的渐进函数。
- complete
  
  类型：Function()
  
  每当动画完成时要调用的函数，针对每个匹配的元素调用一次。

如果不带参数，.show()方法是显示一个元素的最简单方式：

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

匹配的元素将立即显示，不用动画。这基本上等同于调用.css( "display", "block" )，除了display属性会被重置为它最初的值。如果某元素具有display: inline，然后它被隐藏再显示，该属性将再次显示为inline。

注意：如果在样式中使用了!import，譬如display: none !important，则.show()不会覆盖!important。建议使用不同的类配合.addClass()、.removeClass()或.toggleClass()。另一个实现方法是使用.attr( "style", "display: block !important;" )；然而请小心，它也会覆盖元素的style特性。

如果提供了持续时间、一个扁平的对象，或一个“complete”函数，.show()变成了一个动画方法。.show()方法同步变动了宽度、高度以及匹配的元素的不透明度。

持续时间以毫秒计；更高的值指示更慢的动画，不是更快的动画。字符串'fast'和'slow'被提供来分别指示持续时间200毫秒和600毫秒。

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

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

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

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

<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" ).click(function() {
  $( "#book" ).show( "slow", function() {
    // Animation complete.
  });
});

补充说明：

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

示例：

动画将慢慢地显示所有的隐藏的段落，在600毫秒内完成动画。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>show demo</title>
  <style>
  p {
    background: yellow;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.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>

演示：

用200毫秒动画显示第一个<div>，后面依次跟着一个相邻的滑动<div>。当前一个滑动的<div>动画结束后，立即开始下一个动画。

<!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.jquery.com/jquery-1.10.2.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" ).first().show( "fast", function showNext() {
    $( this ).next( "div" ).show( "fast", showNext );
  });
});
 
$( "#hidr" ).click(function() {
  $( "div" ).hide( 1000 );
});
</script>
 
</body>
</html>

演示：

用一个动画，显示所有的<span>和输入控件元素。一旦动完成时，改变文本。

<!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.jquery.com/jquery-1.10.2.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( 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>

.show()返回类型：jQuery

增补版本：1.0.show()

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

增补版本：1.0.show( options )

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

补充说明：

演示：

演示：

演示：