Explication détaillée de l'utilisation de l'instance de fonction jQuery.prevUntil()

La fonction

prevUntil() est utilisée pour sélectionner tous les éléments frères avant chaque élément correspondant jusqu'à ce qu'elle rencontre un élément qui correspond à l'expression spécifiée, et le renvoie sous la forme d'un objet jQuery.

L'expression ici fait référence à : sélecteur (String), élément DOM (Element), objet jQuery.

Vous pouvez également utiliser des sélecteurs pour affiner davantage la plage de sélection et filtrer les éléments qui correspondent au sélecteur spécifié.

L'opposé de cette fonction est la fonction nextUntil(), qui est utilisée pour sélectionner tous les éléments frères après chaque élément correspondant jusqu'à ce qu'un élément correspondant à l'expression spécifiée soit rencontré.

Cette fonction appartient à l'objet (instance) jQuery.

Syntaxe

Cette fonction est ajoutée dans jQuery 1.4.

jQueryObject.prevUntil( [jusqu'àExpr [, filter ] ] )

Paramètre

Description du paramètre

jusqu'àExpr Optionnel/String/Element/spécification de type JQuery An expression, si un élément correspondant à l'expression est rencontré pendant le processus de correspondance en cours, la correspondance en cours sera arrêtée.

filter Chaîne de sélection spécifiée par le type facultatif/String, utilisée pour filtrer les éléments correspondants.

La fonction prevUntil() sélectionnera tous les éléments frères avant chaque élément correspondant de l'objet jQuery actuel jusqu'à ce qu'il rencontre un élément qui correspond à l'expression spécifiée jusqu'àExpr (à l'exclusion de cet élément). De plus, nous pouvons également spécifier le paramètre de filtre pour affiner davantage la portée du filtrage et sélectionner les éléments qui correspondent au sélecteur de filtre.

Si le paramètre UntilExpr est omis, tous les éléments frères précédents sont sélectionnés.

Nouveau support de jQuery 1.6 : le paramètre jusqu'àExpr peut être un élément DOM (Element) ou un objet jQuery.

Valeur de retour

prevUntil()La valeur de retour de la fonction est de type jQuery, renvoyant un nouvel objet jQuery qui encapsule l'objet jQuery actuel avant chaque élément correspondant. Tous éléments frères qui correspondent au filtre de sélection (si spécifié) jusqu'à ce qu'un élément correspondant à l'expression spécifiée jusqu'à ce queExpr soit rencontré.

S'il n'y a aucun élément correspondant, un objet jQuery vide est renvoyé.

Exemple et description

La fonction prevUntil() et la fonction prevAll() ont les codes équivalents suivants :

// 这里的selector表示任意的选择器
// 两者均不带任何参数
$("selector").prevUntil( );
// 等价于
$("selector").prevAll( );

Prenons le code HTML suivant comme exemple :

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

L'exemple de code jQuery suivant est utilisé pour démontrer l'utilisation spécifique de la fonction prevUntil() :

//返回jQuery对象所有匹配元素的标识信息数组
//每个元素形如：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");
//不带任何参数的prevUntil()函数等价于不带任何参数的prevAll()函数
var $result = $n9.prevUntil( );
document.writeln( getTagsInfo( $result ) ); // SPAN#n8,STRONG#n7

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!