当前位置: 首页>>代码示例 >>用法及示例精选 >>正文

JQuery .show()用法及代码示例


用法 
.show() => jQuery

说明：显示匹配的元素。

  • 添加的版本：1.0.show()

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

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

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

  • 添加的版本：1.0.show( options )

    • options
      类型：PlainObject
      要传递给方法的附加选项的映射。
      • duration(默认：400)
        类型：Number 或 String
        确定动画将运行多长时间的字符串或数字。
      • easing(默认：swing)
        类型：String
        一个字符串，指示用于转换的缓动函数。
      • queue(默认：true)
        类型：Boolean 或 String
        一个布尔值，指示是否将动画放置在效果队列中。如果为 false，动画将立即开始。As of jQuery 1.7， queue 选项也可以接受一个字符串，在这种情况下，动画被添加到该字符串表示的队列中。当使用自定义队列名称时，动画不会自动启动；你必须调用.dequeue("queuename")开始它。
      • specialEasing
        类型：PlainObject
        一个对象，包含一个或多个由 properties 参数定义的 CSS 属性及其相应的缓动函数。(添加的版本：1.4)
      • step
        类型：Function(现在是Number，Tween补间)
        为每个动画元素的每个动画属性调用的函数。此函数提供了修改 Tween 对象以在设置之前更改属性值的机会。
      • progress
        类型：Function(Promise动画，Number进度，NumberremainingMs)
        在动画的每个步骤之后要调用的函数，每个动画元素仅调用一次，而与动画属性的数量无关。(添加的版本：1.8)
      • complete
        类型：Function ()
        元素上的动画完成后调用的函数。
      • start
        类型：Function(Promise动画)
        当元素上的动画开始时调用的函数。(添加的版本：1.8)
      • done
        类型：Function(Promise 动画，Boolean jumpedToEnd)
        当元素上的动画完成(其 Promise 对象已解析)时要调用的函数。(添加的版本：1.8)
      • fail
        类型：Function(Promise 动画，Boolean jumpedToEnd)
        当元素上的动画未能完成时调用的函数(其 Promise 对象被拒绝)。(添加的版本：1.8)
      • always
        类型：Function(Promise 动画，Boolean jumpedToEnd)
        当元素上的动画完成或停止但未完成时调用的函数(其 Promise 对象被解析或拒绝)。(添加的版本：1.8)

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

    • duration(默认：400)
      类型：Number 或 String
      确定动画将运行多长时间的字符串或数字。
    • easing(默认：swing)
      类型：String
      一个字符串，指示用于转换的缓动函数。
    • complete
      类型：Function ()
      动画完成后调用的函数，每个匹配元素调用一次。

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

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

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

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

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

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

从 jQuery 1.4.3 开始，可以使用命名缓动函数的可选字符串。缓动函数指定动画在动画中不同点的进展速度。 jQuery 库中唯一的缓动实现是默认实现，称为 swing ，以及以恒定速度进行的实现，称为 linear 。使用 plug-ins 可以使用更多的缓动函数，尤其是 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 hidden, we can show it slowly:
$( "#clickme" ).click(function() {
  $( "#book" ).show( "slow", function() {
    // Animation complete.
  });
});
图 1 - show() 效果图示

其他注意事项：

  • 所有 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-3.5.0.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>

演示：

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

演示：

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

<!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-3.5.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" ).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>

演示：

相关用法


注：本文由纯净天空筛选整理自jquery.com大神的英文原创作品 .show()。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。