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émentsDOM
auquels il faut créer un parent. -
parentDesc
ou : description du parent à créer. Même fonctionnement que la méthodeDom.createElement
. -
target
Facultatiffalse
: 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
DOM
donnés.