Méthode nextUntil() de navigation jQuery
Exemple
Recherche des éléments frères suivants de <dt id="term-2"> jusqu'au prochain <dt>, puis les met en arrière-plan rouge. En même temps, trouvez les éléments frères <dd> suivants de <dt id="term-1"> jusqu'à <dt id="term-3">, et mettez-les en couleur de texte bleue.
$("#term-2").nextUntil("dt").css("background-color", "red");
var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "blue");
Définition et utilisation
La méthode nextUntil() obtient tous les éléments frères suivants de chaque élément, mais pas les éléments correspondant au sélecteur, au nœud DOM ou à l'objet jQuery passé.
Syntaxe 1
.nextUntil(selector,filter)
| Paramètres | Description |
|---|---|
| selector | Valeur de chaîne, contenant l'expression de sélecteur indiquant où arrêter de correspondre aux éléments frères suivants. |
| filter | Valeur de chaîne, contenant l'expression de sélecteur utilisée pour correspondre aux éléments. |
Syntaxe 2
.nextUntil(element,filter)
| Paramètres | Description |
|---|---|
| element | Indique où arrêter de correspondre aux éléments frères suivants le nœud DOM ou l'objet jQuery. |
| filter | Valeur de chaîne, contenant l'expression de sélecteur utilisée pour correspondre aux éléments. |
Explication détaillée
Si un objet jQuery représentant un ensemble d'éléments DOM est fourni, la méthode .nextUntil() nous permet de rechercher les éléments frères suivants des éléments dans l'arbre DOM, et arrête la recherche dès qu'il rencontre l'élément correspondant aux paramètres de la méthode. Le nouveau objet jQuery retourné contient tous les éléments frères suivants, mais pas l'élément correspondant aux paramètres.
Si le sélecteur ne correspond pas ou n'est pas spécifié, tous les éléments frères suivants sont sélectionnés ; sans fourniture de sélecteur de filtrage, les éléments sélectionnés par cette méthode sont identiques à ceux de la méthode .nextAll().
Pour jQuery 1.6, un nœud DOM ou un objet jQuery, plutôt qu'un sélecteur, peut être passing à la méthode .nextUntil().
Cette méthode accepte une expression de sélecteur optionnelle en tant que second paramètre. Si ce paramètre est spécifié, les éléments sont filtrés en fonction de leur correspondance avec le sélecteur.
