jQuery.map(array, callback)


version 1.0 以降

解説

配列を、指定された関数で変換します。

配列のすべての要素に対して指定した関数を実行します。
指定した関数が null を返すと、その要素を削除します。
指定した関数が配列を返すと、その配列の要素は連結され、一つの要素として設定されます。

関数には2つの引数が与えられます。

  • 1番目 : 配列の要素
  • 2番目 : 配列のインデックス

引数

  • array
    Array: 配列
  • callback
    Function: 変換する関数。nullを返すと、その要素を削除します。

戻り値

  • 配列

配列の要素のうち、プロパティ kind が "鳥類" のオブジェクトを抜き出し、種別と名前を持つ配列に変換します。

// kind と name をプロパティに持つオブジェクトの配列
var animals = [
    {kind:"鳥類",  name:"ヤマセミ"},
    {kind:"爬虫類",name:"ヤモリ"},
    {kind:"鳥類",  name:"スズメ"},
    {kind:"魚類",  name:"イワナ"}
];

// マッピング
var birds = $.map(animals, function(item, index){
    return (item.kind == "鳥類") ? item.kind + ":" + item.name : null;
});

// 表示
$.each(birds, function(key, value){
    $("#test_result").append(value).append("<br>");
});