.addClass()

http://api.jqueryui.com/1.10/addClass/

マッチした要素のセットにclassを追加する際に、全てのスタイルの変化をアニメーションさせることが出来るようになります。

.addClass( className [, duration ] [, easing ] [, complete ] )

戻り値:jQuery

引数	説明
className	型：`String` マッチした要素セットに追加したいclass名を、1つまたは複数の場合はスペース区切りで指定します。
duration	初期値：`400` 型：`Number` or `String` アニメーション実行時間をミリ秒単位で指定します。
easing	初期値：`"swing"` 型：`String` 移り変わりを表現するイージングの関数名を指定します。
complete	型：`Function()` アニメーション完了後に実行するコールバック関数を指定します。

jQuery UIのclassアニメーションは、ネイティブのCSS3のtransitionsに似た、ある状態から別の状態への滑らかな移行を提供します。 .addClass()を含む全てのclassアニメーションのメソッドは、durationとイージングのカスタマイズとアニメーション完了後のコールバック関数をサポートします。

全てのstyleがアニメーションするわけではありません。例えば、背景画像はアニメーションのしようがありません。このように幾つかのstyleについては、アニメーションの最後に変更が行われます。

このメソッドはjQueryの.addClass()メソッドを拡張しています。そのため、jQuery UIがロードされる前に.addClass()メソッドが呼び出されてもメソッドが存在しないといったエラーは起こらないはずですが、期待した動作も発生しません。

サンプル

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>addClass demo</title>
    <link rel="stylesheet" href="http://code.jquery.com/ui/1.9.2/themes/base/jquery-ui.css">
    <style>
    div {
        width: 100px;
        height: 100px;
        background-color: #ccc;
    }
    .big-blue {
        width: 200px;
        height: 200px;
        background-color: #00f;
    }
    </style>
    <script src="http://code.jquery.com/jquery-1.8.3.js"></script>
    <script src="http://code.jquery.com/ui/1.9.2/jquery-ui.js"></script>
</head>
<body>

<div></div>

<script>
$( "div" ).click(function() {
    $( this ).addClass( "big-blue", 1000, "easeOutBounce" );
});
</script>

</body>
</html>