База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

document.createElement — създаване на DOM елемент

document.createElement създава нов DOM елемент с посоченото име. Не го добавя автоматично към документа.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

document.createElement(localName)
document.createElement(localName, options)

document.createElement(localName, options) връща нов елемент без родителски възел. Аргументът localName е име на елемент, а не HTML код. Задайте съдържанието чрез textContent и добавете елемента отделно, например с appendChild.

В HTML документ името се преобразува в ASCII малки букви. Невалидно име предизвиква DOMException с име InvalidCharacterError. Използвайте createElementNS, за да изберете изрично пространство от имена.

В незадължителния аргумент options свойството is указва регистрираното име на персонализиран елемент, който разширява вградения елемент, посочен чрез localName. За да създадете автономен персонализиран елемент, подайте регистрираното му име директно като localName, а не като options.is. Safari не поддържа персонализирани елементи, които разширяват вградени елементи, затова тази употреба на options.is не работи във всички браузъри.

Примерът показва само извикване с един аргумент, без options. Той изисква HTML документ в браузър; поддръжката на JavaScript сама по себе си не гарантира, че document е наличен.

Примери

const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);

Резултат

div
Hello
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници