each(callback)

解説

マッチした全てのDOM要素にアクセスし、指定したコールバック関数を実行します。
このコンテキスト内のthisはアクセスしているDOM要素です。

コールバック関数が false を戻すと、ループ処理を停止します。
コールバック関数が true を戻すと、以降の処理をスキップし、次のループを実行します。

引数

• callback
  Function: 各プロパティに対して実行する関数
  このコールバック関数には、インデックス(0から始まる)と、DOM要素が渡されます。
  

  function (index, Element) {
      index; // インデックス
      Element; // DOM要素
  }
  

戻り値

• jQueryオブジェクト

例

例1:全てのH3要素をクリックすると、要素のインデックス番号とテキストをアラートで表示します。
（このドキュメントの上部にある見出しの "引数" と "戻り値" が H3 要素ですので、クリックして試してください。）

$(function(){
    $("h3").each(function(i){
        $(this).click(function() {                        // this はアクセスしているDOM要素
            alert((i+1)                                   // i は 0 から始まるインデックス番号
                + "番目のH3要素がクリックされました。"
                + "[" + $(this).text() + "]");
        });
    });
});

例2:li要素のテキストに、[インデックス番] + "番目"というテキストを追加します。但し、インデックス番号が 2 の要素は除きます。

$("#test_result li").each(function(i){
    if (i == 2) return true;    // インデックス番号が 2 (0 から始まる)のDOM要素への処理はスキップする。
    $(this).append(i+"番目");   // this はアクセスしているDOM要素
});

ページトップヘ

ページトップヘ