CKTIS / JavaScript
document.createElement — créer un élément DOM
document.createElement crée un nouvel élément DOM portant le nom indiqué. Il ne l’insère pas automatiquement dans le document.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) renvoie un nouvel élément sans parent. L’argument localName est un nom d’élément, et non du code HTML. Définissez le contenu avec textContent, puis insérez l’élément séparément, par exemple avec appendChild.
Dans un document HTML, le nom est converti en minuscules ASCII. Un nom invalide déclenche une DOMException nommée InvalidCharacterError. Utilisez createElementNS pour choisir explicitement un espace de noms.
Dans l’argument facultatif options, la propriété is indique le nom enregistré d’un élément personnalisé qui étend l’élément intégré désigné par localName. Pour créer un élément personnalisé autonome, passez son nom enregistré directement comme localName, et non comme options.is. Safari ne prend pas en charge les éléments intégrés personnalisés ; cet usage de options.is ne fonctionne donc pas dans tous les navigateurs.
L’exemple montre uniquement l’appel à un argument, sans options. Il nécessite un document HTML dans un navigateur ; la prise en charge de JavaScript ne garantit pas, à elle seule, que document soit disponible.
Exemples
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Résultat
div Hello true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.