CKTIS / JavaScript
document.createElement — een DOM-element maken
document.createElement maakt een nieuw DOM-element met de opgegeven naam. Het voegt dit niet automatisch aan het document toe.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) geeft een nieuw element zonder bovenliggende knoop terug. Het argument localName is een elementnaam, geen HTML-opmaak. Stel de inhoud in met textContent en voeg het element afzonderlijk toe, bijvoorbeeld met appendChild.
In een HTML-document wordt de naam omgezet naar ASCII-kleine letters. Een ongeldige naam veroorzaakt een DOMException met de naam InvalidCharacterError. Gebruik createElementNS om expliciet een naamruimte te kiezen.
In het optionele argument options geeft de eigenschap is de geregistreerde naam op van een aangepast element dat voortbouwt op het ingebouwde element dat localName aanduidt. Geef voor een autonoom aangepast element de geregistreerde naam rechtstreeks op als localName, niet als options.is. Safari ondersteunt geen aangepaste ingebouwde elementen, dus dit gebruik van options.is werkt niet in alle browsers.
Het voorbeeld toont alleen de aanroep met één argument, zonder options. Het vereist een HTML-document in een browser; ondersteuning voor JavaScript alleen garandeert niet dat document beschikbaar is.
Voorbeelden
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Resultaat
div Hello true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.