Méthode prevUntil() de parcour jQuery
Exemple
Recherche des éléments frères précédents de <dt id="term-2"> jusqu'au précédent <dt>, et les met en rouge. En même temps, recherche des éléments frères <dd> précédents de <dt id="term-3"> jusqu'à <dt id="term-1">, et les met en texte bleu :
$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");
Définition et utilisation
La méthode prevUntil() récupère les éléments frères précédents de chaque élément de la collection d'éléments correspondants, mais n'inclut pas les éléments correspondant à un sélecteur, un nœud DOM ou un objet jQuery.
Syntaxe 1
.prevUntil(Selector, Filtrer)
| Paramètres | Description |
|---|---|
| Selector | Optionnel. Valeur de chaîne contenant l'expression de sélecteur indiquant où arrêter la correspondance des éléments frères précédents. |
| Filtrer | Optionnel. Valeur de chaîne contenant l'expression de sélecteur utilisée pour correspondre aux éléments. |
Syntaxe 2
.prevUntil(Element, Filtrer)
| Paramètres | Description |
|---|---|
| Element | Optionnel. Indique le nœud DOM ou l'objet jQuery où arrêter la correspondance des éléments frères précédents. |
| Filtrer | Optionnel. Valeur de chaîne contenant l'expression de sélecteur utilisée pour correspondre aux éléments. |
Explications détaillées
Si un objet jQuery représentant un ensemble d'éléments DOM est fourni, la méthode .prevUntil() permet de rechercher les éléments frères précédents de ces éléments dans l'arbre DOM, jusqu'à ce qu'un élément correspondant au sélecteur (passé en paramètre à la méthode) soit trouvé. Le nouveau objet jQuery retourné contient tous les éléments frères précédents, mais pas l'élément correspondant au sélecteur spécifié par .prevUntil(). L'ordre des éléments retournés est du plus proche frère au plus éloigné.
Si le sélecteur ne correspond pas ou n'est pas appliqué, tous les éléments frères précédents de la sélection sont sélectionnés ; dans ce cas, les éléments sélectionnés sont les mêmes que ceux sélectionnés par .prevAll() sans sélecteur.
Pour jQuery 1.6, un nœud DOM ou un objet jQuery, et non un sélecteur, peuvent être utilisés en tant que premier paramètre de la méthode .prevUntil().
Cette méthode accepte une expression de sélecteur optionnelle en tant que second paramètre. Si ce paramètre est appliqué, les éléments sont filtrés en fonction de leur correspondance avec le sélecteur.
