prevUntil()函數(shù)用于選取每個匹配元素之前所有的同輩元素，直到遇到符合指定表達(dá)式的元素為止，并以jQuery對象的形式返回。

這里的表達(dá)式是指：選擇器(字符串)、DOM元素(Element)、jQuery對象。

你還可以使用選擇器來進(jìn)一步縮小選取范圍，篩選出符合指定選擇器的元素。

與該函數(shù)相對的是nextUntil()函數(shù)，用于選取每個匹配元素之后所有的同輩元素，直到遇到符合指定表達(dá)式的元素為止。

該函數(shù)屬于jQuery對象(實(shí)例)。

語法

jQuery 1.4 新增該函數(shù)。

jQueryObject.prevUntil( [ untilExpr [, filter ] ] )

參數(shù)

參數(shù) 描述

untilExpr 可選/String/Element/jQuery類型指定的表達(dá)式，如果當(dāng)前匹配過程中遇到符合該表達(dá)式的元素就停止當(dāng)前匹配。

filter 可選/String類型指定的選擇器字符串，用于篩選匹配的元素。

prevUntil()函數(shù)將選取當(dāng)前jQuery對象每個匹配元素之前的所有同輩元素，直到遇到符合指定表達(dá)式untilExpr的元素(不包括該元素)為止。此外，我們還可以指定filter參數(shù)，用于進(jìn)一步縮小篩選范圍，選取出符合filter選擇器的元素。

如果省略untilExpr參數(shù)，則選取之前的所有同輩元素。

jQuery 1.6 新增支持：參數(shù)untilExpr可以為DOM元素(Element)或jQuery對象。

返回值

prevUntil()函數(shù)的返回值為jQuery類型，返回一個新的jQuery對象，該對象封裝了當(dāng)前jQuery對象每個匹配元素之前的所有符合選擇器filter(如果指定了的話)的同輩元素，直到遇到符合指定表達(dá)式untilExpr的元素為止。

如果沒有符合條件的元素，則返回空的jQuery對象。

示例&說明

prevUntil()函數(shù)與prevAll()函數(shù)具有如下等價(jià)代碼：

// 這里的selector表示任意的選擇器
// 兩者均不帶任何參數(shù)
$("selector").prevUntil( );
// 等價(jià)于
$("selector").prevAll( );

以下面這段HTML代碼為例：

<p id="n1">
    <span id="n2" class="foo"></span>
    <label id="n3"></label>
    <span id="n4"></span>
    <span id="n5" class="foo"></span>
</p>
<p id="n6">
    <strong id="n7" class="active"></strong>
    <span id="n8"></span>
    <span id="n9" class="foo"></span>
    <label id="n10"></label>
</p>

以下jQuery示例代碼用于演示prevUntil()函數(shù)的具體用法：

//返回jQuery對象所有匹配元素的標(biāo)識信息數(shù)組
//每個元素形如：tagName或tagName#id(如果有id的話)
function getTagsInfo($doms){
    return $doms.map(function(){
        return this.tagName + (this.id ? "#" + this.id : "");
    }).get();
}
var $n5 = $("#n5");
//匹配n5之前的所有同輩元素，直到遇到包含類名"foo"的元素為止
var $elements = $n5.prevUntil(".foo");
document.writeln( getTagsInfo( $elements ) ); // SPAN#n4,LABEL#n3
//匹配n5之前的所有同輩元素，直到遇到label元素為止
var $matches = $n5.prevUntil("label");
document.writeln( getTagsInfo( $matches ) ); // SPAN#n4
var $label = $("label");
//匹配n5之前包含類名"foo"的所有同輩span元素，直到遇到包含類名"active"的元素為止
var $span_foo = $label.prevUntil(".active", "span.foo");
document.writeln( getTagsInfo( $span_foo ) ); // SPAN#n9,SPAN#n2
var $n9 = $("#n9");
//不帶任何參數(shù)的prevUntil()函數(shù)等價(jià)于不帶任何參數(shù)的prevAll()函數(shù)
var $result = $n9.prevUntil( );
document.writeln( getTagsInfo( $result ) ); // SPAN#n8,STRONG#n7

以上是jQuery.prevUntil()函數(shù)實(shí)例用法詳解的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！