parentsUntil([selector])


version 1.4以降

解説

[祖先要素の検索]
祖先要素をさかのぼって検索し、selectorで指定された要素までの要素を返します。
なお、selectorで指定された要素は含みません。

引数のselectorにマッチする祖先要素がない場合、または、引数が指定されなかった場合は、最上位の祖先要素、つまりhtml以下の全ての要素を返します。

引数

戻り値

  • jQuery: 祖先要素のうち、selectorで指定された要素までの要素

例

例1:idがitem3-3の祖先要素をさかのぼり、idがlevel1までの要素の背景色を黄色にします。(level1は含まない)

$("#item3-3").parentsUntil("#level1").css("background-color", "yellow");


<div id="level1">
    <span id="item1-1">Level1 1番目の要素</span>
    <span id="item1-2">Level1 2番目の要素</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>

指定するセレクタは祖先要素

指定するセレクタは祖先要素でなければなりません。

たとえば、例1の#item3-3要素に対する祖先要素は、#level3（親）、#level2、#level1、 ... body、htmlです。
これ以外の要素（例えばitem2-1）を指定した場合は、最上位の祖先要素、つまりhtmlまでさかのぼるため、全ての要素が返ります。

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

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


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