jQuery UI API - .toggleClass() · W3School jQuery UI 教程

# jQuery UI API - .toggleClass() ## 所属类别 [特效（Effects）](ref-effects.html) | [特效核心（Effects Core）](ref-effects-core.html) | [方法重载（Method Overrides）](ref-overrides.html) ## 用法 **描述：**当动画样式改变时，根据 Class 是否存在以及 switch 参数的值，为匹配的元素集合内的每个元素添加或移除一个或多个 Class。 **返回：**[jQuery](//api.jquery.com/Types/#jQuery) ``` .toggleClass( className [, switch ] [, duration ] [, easing ] [, complete ] ) ``` | 参数 | 类型 | 描述 | 默认值 | | --- | --- | --- | --- | | ClassName | String | 为匹配的元素集合中的每个元素要切换的一个或多个 class 名称，多个 class 名称用空格分隔。 | | switch | Boolean | 一个布尔值，指定 class 应被添加还是被移除。 | | duration | Number 或 String | 一个字符串或一个数字，指定动画将运行多久。 | 400 | | easing | String | 一个字符串，指示要使用的 [easing](api-easings.html) 函数。 | swing | | complete | Function() | 一旦动画完成时要调用的函数。 | ``` .toggleClass( className [, switch ] [, options ] ) ``` | 参数 | 类型 | 描述 | | --- | --- | --- | | ClassName | String | 为匹配的元素集合中的每个元素要切换的一个或多个 class 名称，多个 class 名称用空格分隔。 | | switch | Boolean | 一个布尔值，指定 class 应被添加还是被移除。 | | options | Object | 所有的动画设置。所有的属性是可选的。 * **duration**（默认值：`400`）类型：Number 或 String 描述：一个字符串或一个数字，指定动画将运行多久。 * **easing**（默认值：`swing`）类型：String 描述：一个字符串，指示要使用的 [easing](api-easings.html) 函数。 * **complete** 类型：Function() 描述：一旦动画完成时要调用的函数。 * **children**（默认值：`false`）类型：Boolean 描述：指定动画是否被应用到匹配元素的所有后代。此功能应慎重使用，因为判断元素是否是动画的后代的代价是很大的，会根据后代的数量线性增长。 * **queue**（默认值：`true`）类型：Boolean 或 String 描述：一个布尔值，指示是否将动画放在特效队列中。如果是 false，动画将立即开始。**自 jQuery 1.7 起**，queue 选项也接受一个字符串，在这种情况下，动画添加到由字符串表示的队列中。与原生的 CSS 过渡相似，jQuery UI 的 class 动画提供了一个平稳的从一个状态转换到另一个状态的过渡，同时确保所有样式变化的细节是通过 CSS 来完成的，而不需要使用 JavaScript。所有的 class 动画方法，包括 `.toggleClass()`，允许自定义动画持续时间和 [easing](api-easings.html) 函数，在动画完成时也提供了一个回调。并非所有的样式都可以进行动画添加。例如，对背景图像进行动画化。任何不能动画化的样式都将在动画结束时改变。该插件扩展自 jQuery 内置的 [.toggleClass()](/jquery/html-toggleClass.html) 方法。如果 jQuery UI 未加载，调用 `.toggleClass()` 方法不会直接失败，因为该方法在 jQuery 中存在。但是不会发生预期的行为。 ## 实例为匹配的元素切换 class "big-blue"。 ``` <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>.toggleClass() 演示</title> <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> <style> div { width: 100px; height: 100px; background-color: #ccc; } .big-blue { width: 200px; height: 200px; background-color: #00f; } </style> <script src="//code.jquery.com/jquery-1.10.2.js"></script> <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script> </head> <body> <div></div> <script> $( "div" ).click(function() { $( this ).toggleClass( "big-blue", 1000, "easeOutSine" ); }); </script> </body> </html> ```