.effect() · jQuery UI API 中文文档 1.10

# .effect() Categories: [Effects](http://www.css88.com/jquery-ui-api/category/effects/ "View all posts in Effects") | [Effects Core](http://www.css88.com/jquery-ui-api/category/effects-core/ "View all posts in Effects Core") | [Methods](http://www.css88.com/jquery-ui-api/category/methods/ "View all posts in Methods") ## .effect( effect [, options ] [, duration ] [, complete ] )Returns: [jQuery](http://api.jquery.com/Types/#jQuery) **Description:** 在一个元素上应用一个动画特效。 * #### [.effect( effect [, options ] [, duration ] [, complete ] )](#effect-effect-options-duration-complete) * **effect**Type: [String](http://api.jquery.com/Types/#String)一个字符串，指示哪个[特效](/category/effects/)被使用。 * **options**Type: [Object](http://api.jquery.com/Types/#Object)特效选项和[缓冲函数](/easings/)。 * **duration** (default: `400`)Type: [Number](http://api.jquery.com/Types/#Number) or [String](http://api.jquery.com/Types/#String)一个字符串或者数字决定动画将运行多久。（愚人码头注：三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000) ） * **complete**Type: [Function](http://api.jquery.com/Types/#Function)()在动画完成时执行的函数。 * #### [.effect( options )](#effect-options) * **options**Type: [Object](http://api.jquery.com/Types/#Object)全部动画选项。只有一个必须设置的属性`effect`。 * **effect**Type: [String](http://api.jquery.com/Types/#String)一个字符串，指示哪个[特效](/category/effects/)被使用。 * **easing** (default: `"swing"`)Type: [String](http://api.jquery.com/Types/#String)一个字符串，表示过渡使用哪种 [缓动函数](/easings/)。 * **duration** (default: `400`)Type: [Number](http://api.jquery.com/Types/#Number) or [String](http://api.jquery.com/Types/#String)一个字符串或者数字决定动画将运行多久。（愚人码头注：三种预定速度的字符串("slow", "normal", 或 "fast")或表示动画时长的毫秒数值(如：1000) ） * **complete**Type: [Function](http://api.jquery.com/Types/#Function)()在动画完成时执行的函数。 * **queue** (default: `true`)Type: [Boolean](http://api.jquery.com/Types/#Boolean) or [String](http://api.jquery.com/Types/#String)一个布尔值，指示是否将动画放置在效果队列中。如果为false时，将立即开始动画。 **从jQuery1.7开始**，队列选项也可以接受一个字符串，在这种情况下，在动画被添加到由该字符串表示的队列中。 `.effect()`方法将对一个元素应用一个[特效](effects.html)。许多特效同时也具有显示和隐藏效果，你可以搭配使用[`.show()`](/show/), [`.hide()`](/hide/), 和[`.toggle()`](/toggle/)方法来实现。 ## Example: #### 一个div应用反弹特效。 ``` <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>effect demo</title> <link rel="stylesheet" href="http://code.jquery.com/ui/1.10.3/themes/smoothness/jquery-ui.css"> <style> div { width: 100px; height: 100px; background: #ccc; border: 1px solid #000; } </style> <script src="http://code.jquery.com/jquery-1.9.1.js"></script> <script src="http://code.jquery.com/ui/1.10.3/jquery-ui.js"></script> </head> <body> <p>Click anywhere to apply the effect.</p> <div></div> <script> $( document ).click(function() { $( "div" ).effect( "bounce", "slow" ); }); </script> </body> </html> ```