API : http://api.jquery.com/category/traversing/
Même si les sélecteurs jQuery nous permettent de sélectionner des éléments, nos possibilités sont relativement limitées. jQuery nous propose plusieurs méthodes afin de parcourir le DOM et de faire des tris.
Dans l'exemple ci-dessous, nous ajouterons une classe .first-level
à l'enfant ul
de #menu
.
$('#menu').children('ul').addClass('first-level');
Bien sûr nous ne verrons pas toutes les méthodes en détail, mais voici un tableau récapitulatif.
Méthode | Description |
---|---|
.add() |
Ajoute des éléments au sélecteur actuel |
.addBack() |
Ajoute les précédents éléments sélectionnés au sélecteur actuel |
.children() |
Retourne tous les enfants directs de l'élément sélectionné |
.closest() |
Retourne le plus proche élément ancêtre de l'élément sélectionné |
.contents() |
Les noeuds enfants (y compris les noeuds de texte) |
.each() |
Exécute une fonction à chaque élément identifié |
.end() |
Termine le filtrage en cours et retourne aux éléments sélectionnés précédemment |
.eq() |
Retourne un élément avec un numéro d'index spécifique des éléments sélectionnés (commence à 0) |
.filter() |
Filtre les éléments qui correspondent au sélecteur indiqué |
.find() |
Recherche les éléments enfants qui correspondent au sélecteur |
.first() |
Retourne le premier élément des éléments sélectionnés |
.has() |
Retourne les éléments ayant à l'intérieur le sélecteur indiqué. |
.is() |
Vérifie l'ensemble des éléments sélectionnés contre un sélecteur / élément / objet jQuery, et retourne vrai si au moins un de ces éléments correspond arguments donnés |
.last() |
Retourne le dernier élément des éléments sélectionnés |
.map() |
Retourne un tableau de valeurs, de l'élément sélectionné |
.next() |
Retourne le frère suivant de chaque élément sélectionné, avec filtre (facultatif) |
.nextAll() |
Retourne tous les frères suivants de chaque élément sélectionné, avec filtre (facultatif) |
.nextUntil() |
Retourne tous les frères suivants de chaque élément sélectionné entre deux arguments donnés, avec filtre (facultatif) |
.not() |
Supprime les éléments qui ne correspondent pas au sélecteur |
.offsetParent() |
Retourne le parent positionné (par exemple de manière relative ou absolue) du 1er élément sélectionné. |
.parent() |
Retourne le parent direct, avec filtre (facultatif) |
.parents() |
Retourne tous les éléments ancêtres de l'élément sélectionné |
.parentsUntil() |
Retourne tous les éléments parents entre deux arguments donnés |
.prev() |
Retourne le frère précédent de chaque élément sélectionné, avec filtre (facultatif) |
.prevAll() |
Retourne tous les frères précédents de chaque élément sélectionné, avec filtre (facultatif) |
.prevUntil() |
Retourne tous les frères précédents de chaque élément sélectionné entre deux arguments donnés, avec filtre (facultatif) |
.siblings() |
Retourne tous les frères, avec filtre (facultatif) |
.slice() |
Retourne les éléments se trouvant dans la plage d’indices indiquée (commence à 0) |