jQuery学习笔记：效果

一、 基本
1、 show()
显示隐藏的匹配元素。这个就是 'show( speed, [callback] )' 无动画的版本。如果选择的元素是可见的，这个方法将不会改变任何东西。无论这个元素是通过hide()方法隐藏的还是在CSS里设置了display:none;，这个方法都将有效。
返回值 jQuery
示例：

/*
文档片段 <p style="display: none">Hello</p> 
*/

function  showTest() {
    $( " p " ).show();
}
setTimeout(showTest,  5000 );  // 5 秒显示

2、 show(speed,[callback])
以优雅的动画显示所有匹配的元素，并在显示完成后可选地触发一个回调函数。可以根据指定的速度动态地改变每个匹配元素的高度、宽度和不透明度。
在jQuery 1.3中，padding和margin也会有动画，效果更流畅。
返回值 jQuery
参数

speed (String,Number) : 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如：1000)
callback (Function) : (Optional) 在动画完成时执行的函数，每个元素执行一次。
示例：

Code
/*
文档片段 <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()来隐藏元素
示例：

var  flip  =   0 ;
$( " 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) : (可选) 在动画完成时执行的函数，每个元素执行一次。
示例：

// 用600毫秒的时间将段落缓慢的切换显示状态
$( " 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) : (可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落滑下 
$( " 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) : (可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落滑上  
$( " 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) : (可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落滑上或滑下 
$( " 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) (可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落淡入 
$( " 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) :(可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落淡出
$( " 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) : (可选) 在动画完成时执行的函数
示例：

// 用600毫秒缓慢的将段落的透明度调整到0.66，大约2/3的可见度
 $( " 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) : (可选) 在动画完成时执行的函数
示例：
文档片段：

< button id = " go " >  Run < / button>
< div id = " block " > Hello !< / div> 

代码：
（1）、点击按钮后div元素的几个不同属性一同变化

Code
// 在一个动画中同时应用三种类型的效果
$("#go").click(function() {
    $("#block").animate({
        //点击按钮后div元素的几个不同属性一同变化 
        width: "90%",
        height: "100%",
        fontSize: "10em",
        borderWidth: 10
    }, 1000);
});

（2）、让指定元素左右移动

Code
/*
文档片段  
<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)、

Code
//在600毫秒内切换段落的高度和透明度
$("p").animate({
    height: 'toggle', opacity: 'toggle'
}, "slow"); 


//用500毫秒将段落移到left为50的地方并且完全清晰显示出来（透明度为1） 

$("p").animate({
   left: 50, opacity: 'show'
 }, 500); 

（4）、

// 一个使用“easein”函数提供不同动画样式的例子。只有使用了插件来提供这个“easein”函数，这个参数才起作用。 

$( " 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中新增)
示例：

Code
//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的原始样式，调用回调函数等。
示例：

Code
/*
文档片段  
<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) : 要访问的属性名称
示例：

  jQuery.fx.off  =   true ;
  $( " input " ).click( function (){
      $( " div " ).toggle( " slow " );
  });