parents
Anglais ['peərənts] Américain ['peərənts]
n.Parents (nom pluriel de parent)
until
Anglais [ənˈtɪl] Américain [ʌnˈtɪl]
préparation Jusqu'à… Avant ; ...
conj. Jusqu'à..., avant... ;
Méthode jquery parentsUntil() syntaxe
Fonction : parentsUntil() Obtient les éléments ancêtres de chaque élément dans l'ensemble d'éléments correspondants actuel, jusqu'à (mais sans inclure) l'élément correspondant par le sélecteur, le nœud DOM ou l'objet jQuery.
Syntaxe 1 : .parentsUntil(sélecteur,filtre)
Paramètres :
| Paramètre | Description |
| sélecteur | Facultatif. Valeur de chaîne qui spécifie l'expression du sélecteur où arrêter la correspondance des éléments ancêtres. |
| filtre | Facultatif. Valeur de chaîne contenant l'expression de sélection utilisée pour faire correspondre l'élément. |
Syntaxe 2 : .parentsUntil(element,filter)
Paramètres
| Paramètres | Description |
| element facultatif. Un nœud DOM ou un objet jQuery indiquant où arrêter la correspondance des éléments ancêtres. | |
| Facultatif. Valeur de chaîne contenant l'expression de sélection utilisée pour faire correspondre l'élément. |
Étant donné un objet jQuery représentant une collection d'éléments DOM, la méthode .parentsUntil() nous permet de rechercher les éléments ancêtres de ces éléments dans l'arborescence DOM jusqu'à rencontrer le sélecteur (passé dans la méthode paramètres) jusqu'à ce que les éléments correspondants. L'objet jQuery renvoyé contient tous les éléments ancêtres à l'exception de celui correspondant au sélecteur spécifié par la méthode .parentsUntil(). S'il n'y a pas de correspondance ou qu'aucun sélecteur n'est appliqué, tous les éléments ancêtres seront sélectionnés ; dans ce cas, la méthode sélectionne les mêmes éléments que .parents() si aucun sélecteur n'est fourni. Depuis jQuery 1.6, un nœud DOM ou un objet jQuery, au lieu d'un sélecteur, peut être utilisé comme premier argument de la méthode .parentsUntil(). Cette méthode accepte une expression de sélecteur facultative comme deuxième paramètre. Si ce paramètre est appliqué, les éléments seront filtrés en vérifiant s'ils correspondent à ce sélecteur. Cliquez sur le bouton « Exécuter l'instance » pour afficher l'instance en ligneMéthode jquery parentsUntil() exemple
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="http://apps.bdimg.com/libs/jquery/2.1.1/jquery.min.js"></script>
</head>
<body>
<ul class="level-1 yes">
<li class="item-i">I</li>
<li class="item-ii">II
<ul class="level-2 yes">
<li class="item-a">A</li>
<li class="item-b">B
<ul class="level-3">
<li class="item-1">1</li>
<li class="item-2">2</li>
<li class="item-3">3</li>
</ul>
</li>
<li class="item-c">C</li>
</ul>
</li>
<li class="item-iii">III</li>
</ul>
<script>
$("li.item-a").parentsUntil(".level-1")
.css("background-color", "red");
$("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
.css("border", "3px solid blue");
</script>
</body>
</html>