Méthode parentsUntil

La méthode parentsUntil obtient tous les parents d'un élément - pas seulement le parent direct, mais aussi le grand-parent, l'arrière-grand-parent et ainsi de suite jusqu'à l'élément racine (c'est-à-dire la balise html). La recherche des parents se termine lors de l'atteinte d'un parent correspondant au sélecteur spécifié en paramètre de cette méthode.

Syntaxe

Recherche du parent jusqu'au parent correspondant au sélecteur, le sélecteur peut être un nœud DOM, une expression ou un objet jQuery, on peut également utiliser le deuxième paramètre pour un filtrage supplémentaire. Les deux paramètres sont optionnels :

javascript.parentsUntil([sélecteur], [filtre]);

Le sélecteur peut ne pas être spécifié, dans ce cas la méthode se comportera de manière similaire à la méthode parents :

javascript.parentsUntil();

Exemple

Trouvons l'élément #test puis trouvons tous ses parents jusqu'à l'élément avec la classe zzz en utilisant parentsUntil et ajoutons au début le texte '!' en utilisant prepend :

html<div>
  <div class="zzz">
    <div class="www">
      <div class="www">
        <p id="test">text</p>
      </div>
    </div>
  </div>
</div>
javascript$('#test').parentsUntil('.zzz').prepend('!');

Le code HTML deviendra alors :

html<div>
  <div class="zzz">
    <div class="www">
      !
      <div class="www">
        !<p id="test">text</p>
      </div>
    </div>
  </div>
</div>

Voir aussi

  • méthode parent,
    qui permet d'obtenir le parent direct d'un élément
  • méthode closest,
    qui permet d'obtenir l'élément parent le plus proche satisfaisant le sélecteur
  • méthode parents,
    qui permet d'obtenir tous les parents d'un élément
  • méthode children,
    qui permet d'obtenir les descendants d'un élément