jQuery.map()メソッド
例
$.map() を使用して配列の値を変更する
試してみる »
定義と用法
$.map() 関数は、指定された関数を使用して配列内の各要素(またはオブジェクトの各プロパティ)を処理し、処理結果を新しい配列にカプセル化して返すために使用されます。
注意:1. jQuery 1.6 より前では、この関数は配列の走査のみをサポートしていました。1.6 以降では、オブジェクトの走査もサポートしています。
2. map() は関数に2つの引数を渡します。1つは現在の反復処理の要素またはプロパティ値、もう1つは現在の反復処理の項目の配列インデックスまたはオブジェクトのプロパティ名です。
3. この関数の戻り値は結果の配列の1つの要素になります。戻り値が null または undefined の場合、結果の配列には追加されません。
構文
| 引数 | 説明 |
|---|---|
| object | Array/Object 型 指定された処理対象の配列またはオブジェクト。 |
| callback | Function 型 指定された処理関数。 |
その他の例
元の配列の各値に 4 を加える
元の配列の各値に 4 を加えた後、新しい配列にマッピングします。
元の配列で 0 より大きい数値に 1 を加える
元の配列で 0 より大きい数値に 1 を加えた後、新しい配列にマッピングします。
元の配列の値に 1 を加える
元の配列の各値と、その値に 1 を加えた結果を、新しく生成された配列にマッピングします。
元の配列の値を 2 倍にする
元のオブジェクトの各値を 2 倍した後、新しく生成された配列にマッピングします。
オブジェクト内のキー
オブジェクト内のキーを新しく生成された配列にマッピングします。
元の配列の値の平方
元の配列の各値の2乗を戻り値として、新しく生成された配列にマッピングします。
要素の削除
処理関数で null を返すことで要素を削除します。50 未満の値を削除し、同時に削除されなかった要素の値を 45 減らします。
要素の追加
処理関数で配列を返すことで、最終的に返される結果の配列に要素を追加します。
その他の拡張
jQuery 雑多なメソッド