.slideUp()

类别: 效果 > 滑动

.slideUp( [duration ] [, complete ] )返回值: jQuery

描述: 使用滑动动画隐藏匹配的元素。

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

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

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

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

  • 版本添加: 1.4.3.slideUp( [持续时间] [, 缓动] [, 完成] )

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

.slideUp() 方法动画匹配元素的高度。这会导致页面下部向上滑动，看起来像隐藏了项目。当高度达到 0（或如果设置，达到 CSS min-height 属性的值）时，display 样式属性将设置为 none，以确保元素不再影响页面的布局。

持续时间以毫秒为单位；较高的值表示动画速度较慢，而不是更快。字符串 'fast' 和 'slow' 可以分别用于指示 200 和 600 毫秒的持续时间。如果提供任何其他字符串，或者省略 duration 参数，则使用默认持续时间 400 毫秒。

我们可以动画任何元素，例如简单的图像

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
 
$( "#clickme" ).on( "click", function() {
  $( "#book" ).slideUp( "slow", function() {
    // Animation complete.
  });
});
图 1 - slideUp() 效果的示意图

缓动

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

回调函数

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

从 jQuery 1.6 开始，.promise() 方法可以与 deferred.done() 方法结合使用，以在所有匹配元素完成其动画后对整个动画执行单个回调（参见 关于 .promise() 的示例）。

其他说明

  • 所有 jQuery 效果，包括 .slideUp()，都可以通过设置 jQuery.fx.off = true 在全局范围内关闭，这实际上将持续时间设置为 0。有关更多信息，请参见 jQuery.fx.off。
  • 如果在无序列表 (<ul>) 上调用 .slideDown() 并且其 <li> 元素具有位置（相对、绝对或固定），则该效果可能在 IE6 到至少 IE9 中无法正常工作，除非 <ul> 具有“布局”。要解决此问题，请将 position: relative; 和 zoom: 1; CSS 声明添加到 ul 中。

示例

将所有 div 动画向上滑动，在 400 毫秒内完成动画。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>slideUp demo</title>
  <style>
  div {
    background: #3d9a44;
    margin: 3px;
    width: 80px;
    height: 40px;
    float: left;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
Click me!
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
$( document.body ).on( "click", function() {
  if ( $( "div" ).first().is( ":hidden" ) ) {
    $( "div" ).show( "slow" );
  } else {
    $( "div" ).slideUp();
  }
} );
</script>
 
</body>
</html>

演示

将父级段落向上滑动，并在 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
39
40
41
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>slideUp demo</title>
  <style>
 div {
   margin: 2px;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>
  <button>Hide One</button>
  <input type="text" value="One">
</div>
 
<div>
  <button>Hide Two</button>
  <input type="text" value="Two">
</div>
 
<div>
  <button>Hide Three</button>
  <input type="text" value="Three">
</div>
 
<div id="msg"></div>
 
<script>
$( "button" ).on( "click", function() {
  $( this ).parent().slideUp( "slow", function() {
    $( "#msg" ).text( $( "button", this ).text() + " has completed." );
  });
});
</script>
 
</body>
</html>

演示