jQuery.contains(container, contained)


version 1.4以降

解説

contained(第2引数)要素が、container(第1引数)要素のノードに含まれているかどうかを返します。

引数

  • container
    DOM Element: contained(第2引数)を含んできるかどうかを判別するDOM要素
  • contained
    DOM Element: container(第1引数)のノードに含まれているかどうかを判別するDOM要素

戻り値

  • Boolean: contained(第2引数)要素が、container(第1引数)要素のノードに含まれている場合は true、含まれていない場合は false

例1: span 要素item3-3が、div 要素level2のノードに含まれているかどうかを返します。

alert($.contains(
    $("#level2").get(0),
    $("#item3-3").get(0)
));

例2: span 要素item2-2が、div 要素level3のノードに含まれているかどうかを返します。

alert($.contains(
    $("#level3").get(0),
    $("#item2-2").get(0)
));

<div id="level1"> <span id="item1-1">Level1 1番目の要素</span>
<div id="level2"> <span id="item2-1">Level2 1番目の要素</span> <span id="item2-2">Level2 2番目の要素</span>
<div id="level3"> <span id="item3-1">Level3 1番目の要素</span> <span id="item3-2">Level3 2番目の要素</span> <span id="item3-3">Level3 3番目の要素</span> <span id="item3-4">Level3 4番目の要素</span> <span id="item3-5">Level3 5番目の要素</span> </div>
</div>
</div>

引数の型に注意

このメソッドの引数は、DOM Elementです。jQueryオブジェクトではありません。
get(index) や、getElementById などを使用して、判別対象のDOM要素を取得してください。

DOM要素ではない引数を指定した場合は、JavaScript エラーになります。