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)
));

テスト結果 （#test_result）
<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 エラーになります。





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

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