Dernière mise à jour le .
  1. Dynamique
  2. >
  3. Modules
  4. >
  5. DOM
  6. >
  7. 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éments DOM auquels il faut créer un parent.

  • parentDesc ou : description du parent à créer. Même fonctionnement que la méthode Dom.createElement.

  • target Facultatif false: indique si les parents nouvellements créés doivent remplacer les éléments présents dans domList (true) ou non (false). Par défaut false.

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