.slideUp()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.slideUp()

分类:效果 > 滑移效果

返回: jQuery

.slideUp( [duration ] [, complete ] )

描述:用一个滑移动作隐藏匹配的元素。

加入于: 1.0
.slideUp( [duration ] [, complete ] )
  • duration (默认值:400)
    类型:Number or String
    一个字符串或数字,用来确定动画运行多长时间。
  • complete
    类型:Function()
    一个函数,在动画一旦结束时调用它,对每个匹配的元素调用一次。
加入于: 1.0
.slideUp( options )
  • options
    类型:PlainObject
    传递给该方法的一个额外选项的映射。
    • duration (默认值:400)
      类型:Number or String
      一个字符串或数字,用来确定动画运行多长时间。
    • easing (默认值:swing)
      类型:String
      一个字符串,标明为过渡使用哪种缓动函数。
    • queue (默认值:true)
      类型:Boolean or String
      一个布尔值,标明是否要把动画放到效果队列中。如果是false,动画将立即开始。自从jQuery 1.7,queue选项可以接受一个字符串,那样的话,动画将加到以那个字符串代表的队列中。如果使用了一个自定义队列名,动画不会自动开始;你必须调用.dequeue("queuename")来启动它。
    • specialEasing
      类型:PlainObject
      一个对象,包含了一个或更多的用属性参数和它们对应的缓动函数定义的CSS属性。(加入于1.4
    • step
      类型:FunctionNumber now, Tween tween )
      一个函数,每个变动的元素的每个变动的CSS属性都会调用它。这个函数提供了一个改变Tween对象的机会,可以在该属性被设置之前改变该属性的值。
    • progress
      类型:FunctionPromise animation, Number progress, Number remainingMs )
      一个函数,在每个动画阶结束时调用它,只对每个变动的元素调用一次,无论有多少个变动的属性。(加入于1.8
    • complete
      类型:Function()
      一个函数,在动画一旦结束时调用它。
    • start
      类型:FunctionPromise animation )
      一个函数,每个元素上的动画开始时都会调用它一次。(加入于1.8
    • done
      类型:FunctionPromise animation, Boolean jumpedToEnd )
      一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被解决了)。(加入于1.8
    • fail
      类型:FunctionPromise animation, Boolean jumpedToEnd )
      一个函数,每个元素上的动画结束时都会调用它一次(它的Promise对象被拒绝了)。(加入于1.8
    • always
      类型:FunctionPromise animation, Boolean jumpedToEnd )
      一个函数,在某个元素上的动画,或者在没结束时停止的时候(该元素的Promise对象要么是被解决要么是被拒绝)调用它。(加入于1.8
加入于: 1.4.3
.slideUp( [duration ] [, easing ] [, complete ] )
  • duration (默认值:400)
    类型:Number or String
    一个字符串或数字,用来确定动画运行多长时间。
  • easing (默认值:swing)
    类型:String
    一个字符串,标明为过渡使用哪种缓动函数。
  • complete
    类型:Function()
    一个函数,在动画一旦结束时调用它,对每个匹配的元素调用一次。

.slideUp()方法变动了匹配元素的高度。这会导致页面的下面部分滑上来,隐藏掉项目。在一个隐藏动画后面当高度达到0时(或者,如果设置了CSS属性min-height,则在达到min-height的时候),样式属性display会被设置为none以确保元素不再影响网页的布局。

持续时间用毫秒数指定;更大的数字表示更慢的动画,而不是更快的动画。字符串'fast'表示200毫秒的持续时间,'slow'表示800毫秒的持续时间。如果提供了别的字符串,或者如果省略了duration参数,就会使用duration的默认值400毫秒。

我们可以变动任何元素,比如说一个图像:

<div id="clickme">
  Click here
</div>
<img id="book" src="book.png" alt="" width="100" height="123">

先显示元素,我们可以慢慢隐藏掉它:

$( "#clickme" ).click(function() {
  $( "#book" ).slideUp( "slow", function() {
    // 动画完成。
  });
});
插图1

缓动

自从jQuery 1.4.3,可以使用一个可选的字符串,它命名了一个缓动函数。缓动函数指定了在动画过程内不同的时点上动画推进的速度。在jQuery库内只有两个缓动实现器,一个是默认情况下,称为swing,另一个是以恒定的节奏推进,称为linear。更多的缓动函数要用插件才能使用,特别是使用jQuery UI suite插件。

回调函数

如果提供了,一旦动画结束时,会引发回调函数。这可以用来将不同的动画串成一个事件序列。回调函数并不发送任何参数,但是this被设置为执行动画的DOM元素。如果变动了多个元素,需要注意:回调函数会在每个匹配的元素上各执行一次,不是针对整个动画执行一次。

自从jQuery 1.6,.promise()方法可以与deferred.done()方法配合使用,以当所有的匹配元素都结束它们的动画时,对动画的整体执行一个回调函数(参见example for .promise())。

其它说明

  • 所有的动画效果,包括.slideUp()可以全局性地关闭,只要设置jQuery.fx.off=true,它会有效地把duration设置为0。要了解更多关于它的信息,参见jQuery.fx.off
  • 如果在一个无序列表(<ul>)上调用.slideDown(),而且它的<li>元素有定位(position:relativeposition:absolute或者position:fixed),在IE6、IE7、IE8、IE9中,效果可能不起作用,除非<ul>具有“布局”。为了解决这个问题,请给<ul>添加CSS声明position: relative; zoom: 1;

示例

变动所有的div,让它向上滑移,在400毫秒内完成动画。

<!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.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
Click me!
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
$( document.body ).click(function() {
  if ( $( "div:first" ).is( ":hidden" ) ) {
    $( "div" ).show( "slow" );
  } else {
    $( "div" ).slideUp();
  }
});
</script>
 
</body>
</html>

演示结果

变动所有的div,让它向上滑移,在200毫秒内完成动画。一旦动画结束,跳出提示框。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>slideUp demo</title>
  <style>
 div {
   margin: 2px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.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" ).click(function() {
  $( this ).parent().slideUp( "slow", function() {
    $( "#msg" ).text( $( "button", this ).text() + " has completed." );
  });
});
</script>
 
</body>
</html>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/slideup.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。