Dynamique.js - Documentation DOM.createParent

Version:
Dernière mise à jour le 28/08/2018.

DOM.createParent

Crée un noeud parent à l'ensemble des éléments DOM donnés. Les éléments sont alors déplacés dans leur nouveau parent.

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 le parent nouvellement créé doit 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é.

Exemple sans Dynamique

Exemple 1: Création d'un nouveau parent


						const elem = document.getElementsByTagName("a");
						// 	elem = [HTMLAnchorElement, HTMLAnchorElement];
						
							Dom.createParent(elem, { tagName : "div" });
						// 	===
						// 	Dom.createParent(elem, { tagName : "div" }, false);
						
						// 	elem = [HTMLAnchorElement, HTMLAnchorElement];

Exemple 2: Création et sélection d'un nouveau parent


						const elem = document.getElementsByTagName("a");
						// elem = [HTMLAnchorElement, HTMLAnchorElement];
						
						Dom.createParent(elem, { tagName : "div" }, true);
						
						// elem = [HTMLDivElement];

Exemples avec Dynamique

Exemple 1: Création d'un nouveau parent


						const elem = Dynamique("a").createParent({ tagName : "div" });
						
						// 	elem = [HTMLAnchorElement, HTMLAnchorElement];

Exemple 2: Création et sélection d'un nouveau parent


						const elem = Dynamique("a").createParent({ tagName : "div" }, true);
						
						// elem = [HTMLDivElement];

Compatibilité

Méthode codée en EcmaScript 6.

Méthodes liées

Méthode createParentAll: Crée un parent à chaque élément DOM donné.