jQuery UI API – .switchClass()
所屬類別
特效(Effects) | 特效核心(Effects Core) | 方法重載(Method Overrides)
用法
描述:當動畫樣式改變時,為匹配的元素集合內的每個元素添加和移除指定的Class。
返回: jQuery
.switchClass( removeClassName, addClassName [, duration ] [, easing ] [, complete ] )
参数 | 类型 | 描述 | 默认值 |
---|---|---|---|
removeClassName | String | 要从每个匹配的元素的 class 属性中移除的一个或多个 class 名称,多个 class 名称用空格分隔 。 | |
addClassName | String | 要添加到每个匹配的元素的 class 属性中的一个或多个 class 名称,多个 class 名称用空格分隔。 | |
duration | Number 或 String | 一个字符串或一个数字,指定动画将运行多久。 | 400 |
easing | String | 一个字符串,指示要使用的 easing 函数。 | swing |
complete | Function() | 一旦动画完成时要调用的函数。 |
.switchClass( removeClassName, addClassName [, options ] )
参数 | 类型 | 描述 |
---|---|---|
removeClassName | String | 要从每个匹配的元素的 class 属性中移除的一个或多个 class 名称,多个 class 名称用空格分隔 。 |
addClassName | String | 要添加到每个匹配的元素的 class 属性中的一个或多个 class 名称,多个 class 名称用空格分隔。 |
options | Object | 所有的动画设置。所有的属性是可选的。
|
.switchClass()
方法允許您在動畫過渡中,添加Class的同時移除Class。
與原生的CSS 過渡相似,jQuery UI 的class 動畫提供了一個平穩的從一個狀態轉換到另一個狀態的過渡,同時確保所有樣式變化的細節是通過CSS 來完成的,而不需要使用JavaScript。 所有的class動畫方法,包括.switchClass()
,允許自定義動畫持續時間和easing函數,在動畫完成時也提供了一個回調。
並非所有的樣式都可以進行動畫添加。 例如,對背景圖像進行動畫化。 任何不能動畫化的樣式都將在動畫結束時改變。
該插件擴展自jQuery 內置的.switchClass() 方法。 如果jQuery UI未加載,調用.switchClass()
方法不會直接失敗,因為該方法在jQuery中存在。 但是不會發生預期的行為。
實例
添加class "blue" 到匹配的元素,並從匹配的元素中移除class "big"。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>.switchClass() 演示</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 { width: 200px; height: 200px; } .blue { 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 class="big"></div> <script> $( "div" ).click(function() { $( this ).switchClass( "big", "blue", 1000, "easeInOutQuad" ); }); </script> </body> </html>