1、 show()
显示隐藏的匹配元素。这个就是 'show( speed, [callback] )' 无动画的版本。如果选择的元素是可见的,这个方法将不会改变任何东西。无论这个元素是通过hide()方法隐藏的还是在CSS里设置了display:none;,这个方法都将有效。
返回值 jQuery
示例:
文档片段 <p style="display: none">Hello</p>
*/
function showTest() {
$( " p " ).show();
}
setTimeout(showTest, 5000 ); // 5 秒显示
以优雅的动画显示所有匹配的元素,并在显示完成后可选地触发一个回调函数。可以根据指定的速度动态地改变每个匹配元素的高度、宽度和不透明度。
在jQuery 1.3中,padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (Optional) 在动画完成时执行的函数,每个元素执行一次。
示例:
/*
文档片段 <p style="display: none">Hello</p>
*/
//用缓慢的动画将隐藏的段落显示出来,历时600毫秒。
$("p").show("slow");
/*
文档片段 <p style="display: none">Hello</p>
*/
//用迅速的动画将隐藏的段落显示出来,历时200毫秒,并在之后执行反馈
$("p").show("fast",function(){
$(this).text("Animation Done!");
});
/*
文档片段 <p style="display: none">Hello</p>
*/
//将隐藏的段落用将近4秒的时间显示出来,并在之后执行一个反馈
$("p").show(4000,function(){
$(this).text("Animation Done");
});
3、hide()
隐藏显示的元素这个就是 'hide( speed, [callback] )' 的无动画版。如果选择的元素是隐藏的,这个方法将不会改变任何东西。
返回值 jQuery
示例:
文档片段 <p>Hello</p>
*/
$( " p " ).hide()
4、hide(speed,[callback])
以优雅的动画隐藏所有匹配的元素,并在显示完成后可选地触发一个回调函数。
可以根据指定的速度动态地改变每个匹配元素的高度、宽度和不透明度。在jQuery 1.3中,padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) :三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (可选) 在动画完成时执行的函数,每个元素执行一次。
示例:
文档片段 <p>Hello</p>
*/
// 用600毫秒的时间将段落缓慢的隐藏
$( " p " ).hide( " slow " )
// 用200毫秒将段落迅速隐藏,之后弹出一个对话框
$( " p " ).hide( " fast " , function () {
alert( " Animation Done! " );
});
5、toggle()
切换元素的可见状态。如果元素是可见的,切换为隐藏的;如果元素是隐藏的,切换为可见的。
返回值 jQuery
示例:
文档片段 <p>Hello</p><p style="display: none">Hello Again</p>
返回结果 <p tyle="display: none">Hello</p><p style="display: block">Hello Again</p>
*/
// 切换所有段落的可见状态
$( " p " ).toggle()
6、toggle( switch )
根据switch参数切换元素的可见状态(ture为可见,false为隐藏)。
如果switch设为true,则调用show()方法来显示匹配的元素,如果switch设为false则调用hide()来隐藏元素。
返回值 jQuery
参数
switch(Boolean) : 如果switch设为true,则调用show()方法来显示匹配的元素,如果switch设为false则调用hide()来隐藏元素
示例:
$( " button " ).click( function () {
$( " p " ).toggle(flip ++ % 2 == 0 );
});
7、toggle(speed,[callback])
以优雅的动画切换所有匹配的元素,并在显示完成后可选地触发一个回调函数。
可以根据指定的速度动态地改变每个匹配元素的高度、宽度和不透明度。在jQuery 1.3中,padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) :三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (可选) 在动画完成时执行的函数,每个元素执行一次。
示例:
$( " p " ).toggle( " slow " );
// 用200毫秒将段落迅速切换显示状态,之后弹出一个对话框
$( " p " ).toggle( " fast " , function () {
alert( " Animation Done. " );
});
二、滑动
1、slideDown(speed,[callback])
通过高度变化(向下增大)来动态地显示所有匹配的元素,在显示完成后可选地触发一个回调函数。
这个动画效果只调整元素的高度,可以使匹配的元素以“滑动”的方式显示出来。在jQuery 1.3中,上下的padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) :三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (FunctionFunction) : (可选) 在动画完成时执行的函数
示例:
$( " p " ).slideDown( " slow " );
// 用200毫秒快速将段落滑下,之后弹出一个对话框
$( " p " ).slideDown( " fast " , function () {
alert( " Animation Done. " );
});
2、slideUp(speed,[callback])
通过高度变化(向上减小)来动态地隐藏所有匹配的元素,在隐藏完成后可选地触发一个回调函数。
这个动画效果只调整元素的高度,可以使匹配的元素以“滑动”的方式隐藏起来。在jQuery 1.3中,上下的padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (可选) 在动画完成时执行的函数
示例:
$( " p " ).slideUp( " slow " );
// 用200毫秒快速将段落滑上,之后弹出一个对话框
$( " p " ).slideUp( " fast " , function () {
alert( " Animation Done. " );
});
3、slideToggle(speed,[callback])
通过高度变化来切换所有匹配元素的可见性,并在切换完成后可选地触发一个回调函数。
这个动画效果只调整元素的高度,可以使匹配的元素以“滑动”的方式隐藏或显示。在jQuery 1.3中,上下的padding和margin也会有动画,效果更流畅。
返回值 jQuery
参数
speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (可选) 在动画完成时执行的函数
示例:
$( " p " ).slideToggle( " slow " );
// 用200毫秒快速将段落滑上或滑下,之后弹出一个对话框
$( " p " ).slideUp( " fast " , function () {
alert( " Animation Done. " );
});
三、淡入淡出
1、fadeIn(speed,[callback])
通过不透明度的变化来实现所有匹配元素的淡入效果,并在动画完成后可选地触发一个回调函数。
这个动画只调整元素的不透明度,也就是说所有匹配的元素的高度和宽度不会发生变化。
返回值 jQuery
参数
speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) : (Optional) (可选) 在动画完成时执行的函数
示例:
$( " p " ).fadeIn( " slow " );
// 用200毫秒快速将段落淡入,之后弹出一个对话框
$( " p " ).fadeIn( " fast " , function () {
alert( " Animation Done. " );
});
2、fadeOut(speed,[callback])
通过不透明度的变化来实现所有匹配元素的淡出效果,并在动画完成后可选地触发一个回调函数。
这个动画只调整元素的不透明度,也就是说所有匹配的元素的高度和宽度不会发生变化。
返回值 jQuery
参数
speed (String,Number) :三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
callback (Function) :(可选) 在动画完成时执行的函数
示例:
$( " p " ).fadeOut( " slow " );
// 用200毫秒快速将段落淡出,之后弹出一个对话框
$( " p " ).fadeOut( " fast " , function () {
alert( " Animation Done. " );
});
3、fadeTo(speed,opacity,[callback])
把所有匹配元素的不透明度以渐进方式调整到指定的不透明度,并在动画完成后可选地触发一个回调函数。
这个动画只调整元素的不透明度,也就是说所有匹配的元素的高度和宽度不会发生变化。
返回值 jQuery
参数
speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
opacity (Number) : 要调整到的不透明度值(0到1之间的数字).
callback (Function) : (可选) 在动画完成时执行的函数
示例:
$( " p " ).fadeTo( " slow " , 0.66 );
// 用200毫秒快速将段落的透明度调整到0.25,大约1/4的可见度,之后弹出一个对话框
$( " p " ).fadeTo( " fast " , 0.25 , function () {
alert( " Animation Done. " );
});
四、自定义
1、animate(params[,duration[,easing[,callback]]])
用于创建自定义动画的函数。
这个函数的关键在于指定动画形式及结果样式属性对象。这个对象中每个属性都表示一个可以变化的样式属性(如“height”、“top”或“opacity”)。
注意:所有指定的属性必须用骆驼形式,比如用marginLeft代替margin-left. 而每个属性的值表示这个样式属性到多少时动画结束。如果是一个数值,样式属性就会从当前的值渐变到指定的值。如果使用的是“hide”、“show”或“toggle”这样的字符串值,则会为该属性调用默认的动画形式。
在 jQuery 1.2 中,你可以使用 em 和 % 单位。另外,在 jQuery 1.2 中,你可以通过在属性值前面指定 "+=" 或 "-=" 来让元素做相对运动。
jQuery 1.3中,如果duration设为0则直接完成动画。而在以前版本中则会执行默认动画。
返回值 jQuery
参数
params (Options) : 一组包含作为动画属性和终值的样式属性和及其值的集合
duration (String,Number) : (可选) 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
easing (String) : (可选) 要使用的擦除效果的名称(需要插件支持).默认jQuery提供"linear" 和 "swing".
callback (Function) : (可选) 在动画完成时执行的函数
示例:
文档片段:
< div id = " block " > Hello !< / div>
代码:
(1)、点击按钮后div元素的几个不同属性一同变化
// 在一个动画中同时应用三种类型的效果
$("#go").click(function() {
$("#block").animate({
//点击按钮后div元素的几个不同属性一同变化
width: "90%",
height: "100%",
fontSize: "10em",
borderWidth: 10
}, 1000);
});
(2)、让指定元素左右移动
/*
文档片段
<button id="left">«</button> <button id="right">»</button>
<div class="block"></div>
*/
$("#right").click(function() {
$(".block").animate({ left: '+50px' }, "slow");
});
$("#left").click(function() {
$(".block").animate({ left: '-50px' }, "slow");
});
(3)、
//在600毫秒内切换段落的高度和透明度
$("p").animate({
height: 'toggle', opacity: 'toggle'
}, "slow");
//用500毫秒将段落移到left为50的地方并且完全清晰显示出来(透明度为1)
$("p").animate({
left: 50, opacity: 'show'
}, 500);
(4)、
$( " p " ).animate({
opacity: ' show '
}, " slow " , " easein " );
2、animate(params,options)
用于创建自定义动画的函数。这个函数的关键在于指定动画形式及结果样式属性对象。这个对象中每个属性都表示一个可以变化的样式属性(如“height”、“top”或“opacity”)。
注意:所有指定的属性必须用骆驼形式,比如用marginLeft代替margin-left. 而每个属性的值表示这个样式属性到多少时动画结束。如果是一个数值,样式属性就会从当前的值渐变到指定的值。如果使用的是“hide”、“show”或“toggle”这样的字符串值,则会为该属性调用默认的动画形式。
在 jQuery 1.2 中,你可以使用 em 和 % 单位。另外,在 jQuery 1.2 中,你可以通过在属性值前面指定 "+=" 或 "-=" 来让元素做相对运动。
返回值 jQuery
参数
duration (String,Number) : (默认值: "normal") 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如:1000)
easing (String) : (默认值: "swing") 要使用的擦除效果的名称(需要插件支持).默认jQuery提供"linear" 和 "swing".
complete (Function) : 在动画完成时执行的函数
step (Callback) :
queue (Boolean) : (默认值: true) 设定为false将使此动画不进入动画队列 (jQuery 1.2中新增)
示例:
//1、第一个按钮按了之后展示了不在队列中的动画。在div扩展到90%的同时也在增加字体,一旦字体改变完毕后,边框的动画才开始。
//第二个按钮按了之后就是一个传统的链式动画,即等前一个动画完成后,后一个动画才会开始.
$("#go1").click(function() {
$("#block1").animate({ width: "90%" }, { queue: false, duration: 5000 })
.animate({ fontSize: '10em' }, 1000)
.animate({ borderWidth: 5 }, 1000);
});
$("#go2").click(function() {
$("#block2").animate({ width: "90%" }, 1000)
.animate({ fontSize: '10em' }, 1000)
.animate({ borderWidth: 5 }, 1000);
});
//2、用600毫秒切换段落的高度和透明度
$("p").animate({
height: 'toggle', opacity: 'toggle'
}, { duration: "slow" });
//3、用500毫秒将段落移到left为50的地方并且完全清晰显示出来(透明度为1)
$("p").animate({
left: 50, opacity: 'show'
}, { duration: 500 });
//4、一个使用“easein”函数提供不同动画样式的例子。只有使用了插件来提供这个“easein”函数,这个参数才起作用。
$("p").animate({
opacity: 'show'
}, { duration: "slow", easing: "easein" });
3、stop( [clearQueue], [gotoEnd])
停止所有在指定元素上正在运行的动画。如果队列中有等待执行的动画(并且clearQueue没有设为true),他们将被马上执行
返回值 jQuery
参数
clearQueue (Boolean) : 可选,如果设置成true,则清空队列。可以立即结束动画。
gotoEnd (Boolean) : 可选,让当前正在执行的动画立即完成,并且重设show和hide的原始样式,调用回调函数等。
示例:
/*
文档片段
<button id="go">Go</button> <button
id="stop">STOP!</button>
<div class="block"></div>
<button id="go">Go</button> <button
id="stop">STOP!</button>
<div class="block"></div>
*/
// 开始动画
$("#go").click(function() {
$(".block").animate({ left: '+200px' }, 5000);
});
// 当点击按钮后停止动画
$("#stop").click(function() {
$(".block").stop();
});
五、设置
1、jQuery.fx.off
关闭页面上所有的动画。
把这个属性设置为true可以立即关闭所有动画(所有效果会立即执行完毕)。有些情况下可能需要这样,比如:
* 你在配置比较低的电脑上使用jQuery。
* 你的一些用户由于动画效果而遇到了 可访问性问题
注:当把这个属性设成false之后,可以重新开启所有动画。
返回值 Boolean
参数
name (String) : 要访问的属性名称
示例:
$( " input " ).click( function (){
$( " div " ).toggle( " slow " );
});