Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources