jQuery.fn.extend(object)


version 1.0 以降

jQueryオブジェクトの prototype を拡張します。
jQueryオブジェクトに対する処理を追加したり、プラグインを作成する場合などに使用します。

jQueryの連鎖性(Chainability)を保つため、戻り値は、可能な限りjQueryオブジェクトを戻すようにしましょう。 (もちろん、それ以外の戻り値を戻すことが目的であれば別です。)

引数

  • obj
    Object: jQueryオブジェクトの prototype を拡張するオブジェクト

戻り値

  • Object: ユーザ定義

関連


例1:マッチした要素の後ろに、順番を付加する markIndex メソッドを追加します。

$.fn.extend({
    markIndex: function() {
        return this.each(function(i) {
            $(this).after("(" + (i+1) + "番目)");
        });
    }
});

// 実行
$("#test_result > img").markIndex();






jQuery.extend() と jQuery.fn.extend() の違い

jQuery.extend() は、jQueryの名前空間を拡張します。
ユーティリティメソッドなど、jQueryのクラスメソッドの様に呼び出すメソッドの実装などに使用します。

jQuery.fn.extend() は、jQueryオブジェクトの prototype を拡張します。
jQueryオブジェクトに対する処理を追加したり、プラグインを作成する場合などに使用します。