jQuery UI API - .switchClass()
カテゴリ
エフェクト(Effects) | エフェクトコア(Effects Core) | メソッドオーバーライド(Method Overrides)
使用方法
説明:アニメーションのスタイルが変更されるとき、マッチした要素セット内の各要素に対して、指定されたクラスを追加および削除します。
戻り値:jQuery
| パラメータ | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| removeClassName | String | マッチした各要素の class 属性から削除する1つ以上のクラス名。複数のクラス名はスペースで区切ります。 | |
| addClassName | String | マッチした各要素の class 属性に追加する1つ以上のクラス名。複数のクラス名はスペースで区切ります。 | |
| duration | Number または String | アニメーションの実行時間を指定する文字列または数値。 | 400 |
| easing | String | 使用するものを示す文字列easing関数。 | swing |
| complete | Function() | アニメーションが完了したときに呼び出される関数。 |
| パラメータ | 型 | 説明 |
|---|---|---|
| removeClassName | String | マッチした各要素の class 属性から削除する1つ以上のクラス名。複数のクラス名はスペースで区切ります。 |
| addClassName | String | マッチした各要素の class 属性に追加する1つ以上のクラス名。複数のクラス名はスペースで区切ります。 |
| options | Object | すべてのアニメーション設定。すべてのプロパティはオプションです。
|
.switchClass()このメソッドを使用すると、アニメーションの遷移中に Class を追加すると同時に Class を削除できます。
ネイティブの CSS トランジションと同様に、jQuery UI の class アニメーションは、ある状態から別の状態へのスムーズな遷移を提供し、スタイル変更の詳細がすべて CSS によって行われることを保証します。JavaScript を使用する必要はありません。すべての class アニメーションメソッドには、以下が含まれます。.switchClass().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>
その他の拡張