Dernière mise à jour le .
- Dynamique
- >
- Modules
- >
- DOM
- >
- createParentAll
DOM.createParentAll
Crée un parent à chaque élément DOM donné.
Si plusieurs éléments ont le même parent, un seul sera créé.
Synthaxe
DOM.createParent(domList, parentDesc, target);
Lorsque le module DOM est utilisé avec Dynamique, le paramètre domList doit être omis.
Où:
-
domList: tableau d'élémentsDOMauquels il faut créer un parent. -
parentDescou : description du parent à créer. Même fonctionnement que la méthodeDom.createElement. -
targetFacultatiffalse: indique si les parents nouvellements créés doivent remplacer les éléments présents dansdomList(true) ou non (false). Par défautfalse.
Valeur de retour
Le contexte englobant this est retourné.
Exemples sans Dynamique
Exemple 1: Création de nouveaux parents
const elem = document.getElementsByTagName("a");
// elem = [HTMLAnchorElement, HTMLAnchorElement];
// Chaque lien n'ayant pas le même parent, deux parents seront créés
Dom.createParentAll(elem, { tagName : "div" });
// ===
// Dom.createParentAll(elem, { tagName : "div" }, false);
// elem = [HTMLAnchorElement, HTMLAnchorElement];
Exemple 2: Création d'un nouveau parent
const elem = document.getElementsByTagName("a");
// elem = [HTMLAnchorElement, HTMLAnchorElement];
// Les deux liens ont le même parent, un seul parent sera créé
Dom.createParentAll(elem, { tagName : "div" });
// Les deux liens ont désormais comme parent un HTMLDivElement
// elem = [HTMLAnchorElement, HTMLAnchorElement];
Exemple 3: Création et sélection d'un nouveau parent
const elem = document.getElementsByTagName("a");
// Les deux liens ont le même parent, un seul parent sera créé
// On précise que l'on souhaite récupérer le parent créé
Dom.createParentAll(elem, { tagName : "div" }, true);
// elem = [HTMLDivElement];
Exemples avec Dynamique
Exemple 1: Création de nouveaux parents
Dynamique("a").createParentAll(elem, { tagName : "div" });
Exemple 2: Création et sélection d'un nouveau parent
Dynamique("a").createParentAll(elem, { tagName : "div" }, true);
Compatibilité
Méthode codée en EcmaScript 6.
Méthodes liées
-
Méthode createParent: Crée un noeud parent à l'ensemble des éléments
DOMdonnés.