each(callback)

Core/API/jQuery

合致した全てのエレメントに対して関数を実行する。

これは、合致するエレメントが見つかる度に1度ずつ、毎回関数が実行されることを意味する。
その際に、関数内でthisポインタは各エレメントを指す。
そしてコールバック関数は第一引数に、エレメントセットの中での、ゼロから始まるインデックスを受け取る。

関数内で戻り値にfalseを設定した場合、ループはそこで終了。これは通常のloop構文におけるbreakのような役割である。
戻り値にtrueを返した場合は、次のループに処理が移る。こちらはloop文のcontinueのような働きである。

callback: Function
ループ中で実行される関数

戻り値

jQuery

jQueryオブジェクト

サンプル

サンプル1

関数内で通常のDOM ElementではなくjQueryオブジェクトを使いたい場合、$(this)のように記述。

$("span").click(function () {
  $("li").each(function(){
    $(this).toggleClass("example");
  });
});

[全コードを表示] [実行結果を単体で表示]

サンプル2

idがstopであるdivが見つかった時点で、戻り値にfalseを返してやることで処理を中断する。
そしてstopが見つかった時のindexの値を出力する。

$("button").click(function () {
  $("div").each(function (index, domEle) {
    // domEle == this
    $(domEle).css("backgroundColor", "yellow"); 
    if ($(this).is("#stop")) {
      $("span").text("Stopped at div index #" + index);
      return false;
    }
  });
});