当前位置: 首页 > 中文手册 > jQuery.animate() 函数详解

jQuery.animate() 函数详解

animate()函数用于执行一个基于css属性的自定义动画

你可以为匹配的元素设置css样式,animate()函数将会执行一个从当前样式到指定的css样式的一个过渡动画。

例如:某个div元素的当前高度为100px,将其CSS height属性设为200px,animate()将会执行一个将div元素的高度从100px逐渐增加到200px的过渡动画。

该函数属于jQuery对象(实例)。

语法

jQuery 1.0 新增该函数。animate()函数主要有以下两种形式的用法:

用法一

jQueryObject.animate( cssProperties [, duration ] [, easing ] [, complete ] )

用法二

jQueryObject.animate( cssProperties, options )

用法二是用法一的变体。以对象形式指定所需的选项参数(可指定比用法一更多的选项参数)。

参数

参数描述
cssPropertiesObject类型一个或多个css属性的键值对所构成的Object对象。
duration可选/String/Number类型指定动画运行多长时间(毫秒数),默认值为400。该参数也可以为字符串"fast"(=200)或"slow"(=600)。
easing可选/String类型指定使用何种动画效果,默认为"swing",还可以设为 "linear"或其他自定义的动画样式函数。
complete可选/Function类型元素显示完毕后需要执行的函数。函数内的this指向当前DOM元素。
optionsObject类型指定的选项参数对象。

参数options对象可以识别如下的属性(以下属性均是可选的):

属性属性描述
duration参见参数duration
easing参见参数easing
complete参见参数complete
queueBoolean类型指示是否将动画放入效果队列中,默认为true。从1.7版本开始,该参数可以为字符串,用于放入指定名称的效果队列。如果你指定的队列不会自动开始,你需要手动调用dequeue("queueName")来启动队列。

此外,jQuery 1.4 和 1.8 还为参数options新增了许多新的选项支持,但这些参数并不常用,此处不再赘述,详见jQuery官方文档

返回值

animate()函数的返回值为jQuery类型,返回当前jQuery对象本身。

示例&说明

除了以下提到的值外,所有动画css属性都应该可以变化为一个单一的数值。使用基本的jQuery功能,大多数非数值的css属性都无法用来执行动画。例如:width、height、left、top都可用于动画,但color、background-color无法用于动画(除非使用jQuery.Color()插件)。除非你为属性值指定了单位(例如:px、em、%),否则默认的数值单位为像素(px)。

速写的css属性可能无法获得完整全面的支持,例如:border、margin等,因此不推荐使用。

你还可以将css属性值设为一些特定的字符串,例如:"show"、"hide"、"toggle",则jQuery会调用该属性默认的动画形式。

此外,css属性值也可以是相对的,你可以为属性值加上前缀"+="或"-=",以便于在原来的属性值上增加或减少指定的数值。例如:{ "height": "+=100px" },表示在原有高度的基础上增加100px。

请参考下面这段初始HTML代码:

<div id="myDiv" style="width:300px; height: 100px; background-color: #eee;">CodePlayer</div>
动画效果:
<select id="animation">
	<option value="1">动画1</option>
	<option value="2">动画2</option>
	<option value="3">动画3</option>
	<option value="4">动画4</option>
	<option value="5">动画5</option>
</select>
<input id="exec" type="button" value="执行动画" >

以下是与animate()函数相关的jQuery示例代码,以演示animate()函数的具体用法:

$("#exec").click( function(){
	var v = $("#animation").val();
	var $myDiv = $("#myDiv");
	if(v == "1"){
		// 数值的单位默认是px
		$myDiv.animate( { height: 200 } );
	}else if(v == "2"){
		// 在现有高度的基础上增加300px (如果原来是100px,增加后就是400px)
		// 多个动画连续执行
		$myDiv.animate( { height: "+=300px" }, "slow" ); 
		$myDiv.animate( { width: "50%" }, 1000 );		
		$myDiv.animate( { width: "200px", height: "100px" }, 1000 );		
	}else if(v == "3"){
		// font-size或fontSize均可,由多个单词构成的属性均是如此
		$myDiv.animate( { fontSize: "30px" }, 2000 );
		$myDiv.animate( { fontSize: "14px" }, 2000, function(){
			alert("动画3执行完毕!");
		});
	}else if(v == "4"){
		$myDiv.animate( { width: "50%", height: "50%" }, { duration: 2000, easing: "linear" });
	}else if(v == "5"){
		// 根据高度切换显示/隐藏,显示时高度从0增加到原高度,隐藏时高度从原高度减小到0
		$myDiv.animate( { height: "toggle" });
	}	
} );

运行代码

83 9
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。