map(callback)


version 1.2 以降

解説

jQueryオブジェクトが持つ要素を、指定された関数で変換します。

jQueryオブジェクトが持つすべての要素に対して指定した関数を実行します。
指定した関数が null を返すと、その要素を削除します。

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

  • １番目 ： インデックス
  • ２番目 ： DOM要素

引数

  • callback ： 変換する関数。nullを返すと、その要素を削除します。

戻り値

  • 配列

例

"鳥類:" で始まる li 要素を抜き出し、インデックス番号を付与した値を持つ配列に変換します。 

$("<ul>").append($("#test_result li").map(function(index, dom){
    var str = $(dom).text();
    if (str.indexOf("鳥類:") == 0) {
        return $("<li>").text(index + ":" + str).get(0);
    } else {
        return null;
    }
}))
.appendTo("#test_result")
.before("変換後");

  • 鳥類:ヤマセミ
  • 爬虫類:ヤモリ
  • 鳥類:スズメ
  • 魚類:イワナ

ページトップヘページトップヘ

Traversing
eq(index)
has(expr)
filter(expr)
filter(fn)
is(expr)
first()
last()
map(callback)
not(expr)
slice(start, [end])
add(expr)
add(expr, context)
children([expr])
closest(selector, [context])
contents()
find([expr])
next([expr])
nextUntil([selector])
nextAll([expr])
offsetParent()
parent([expr])
parents([expr])
parentsUntil([selector])
prev([expr])
prevUntil([selector])
prevAll([expr])
siblings([expr])
andSelf()
end()


ページトップヘページトップヘ