Résumé
Crée un élément du type spécifié.
Syntaxe
element = document.createElement(tagName);
elementest l'objet Element créé.tagNameest une chaîne spécifiant le type d'élément à créer. L'attribut nodeName de l'élément est initialisée avec la valeur detagName.
Exemple
Ceci crée un nouvel élément <div> et l'insère avant l'élément d'id « org_div1 » :
<html>
<head>
<title>||Travail sur les éléments||</title>
</head>
<script type="text/javascript">
var mon_div = null;
var nouveauDiv = null;
function ajouteElement() {
// crée un nouvel élément div
// et lui donne un peu de contenu
nouveauDiv = document.createElement("div");
nouveauDiv.innerHTML = "<h1>Salutations !</h1>";
// ajoute l'élément qui vient d'être créé et son contenu au DOM
mon_div = document.getElementById("org_div1");
document.body.insertBefore(nouveauDiv, mon_div);
}
</script>
<body onload="ajouteElement()">
<div id='org_div1'> Le texte ci-dessus a été créé dynamiquement.</div>
</body>
</html>
Notes
Si des attributs sont connus avec des valeurs par défaut, les nœuds attributs qui les représentent sont automatiquement créés et attachés à l'élément.
Pour créer un élément avec un namespace qualifié et une URI de namespace, utiliser la méthode createElementNS.
L'implémentation de createElement dans Gecko ne se conforme pas à la spécification DOM pour les documents XUL et XHTML : localName et namespaceURI ne sont pas définis à null sur l'élément créé. Consultez le bug 280692 pour plus de détails.
Spécification
- Spécification DOM Level 2 Core : createElement
- Traduction en français (non normative) : createElement