document.createElement

Общая информация

В HTML-документах создаёт элемент c тем тегом, что указан в аргументе или HTMLUnknownElement, если имя тега не распознаётся.

В XUL-документах создаёт указанный в аргументе элемент XUL.

В остальных случаях создаёт элемент с нулевым NamespaceURI.

Параметры

var element = document.createElement(tagName, [options]);

• element — созданный объект элемента.
• tagName — строка, указывающая элемент какого типа должен быть создан. nodeName создаётся и инициализируется со значением tagName.
• options — необязательный параметр, объект ElementCreationOptions, который может содержать только поле is, указывающее имя пользовательского элемента, созданного с помощью customElements.define() (см. Веб-компоненты).

Пример

Данный пример создаёт новый элемент <div> и вставляет его перед элементом с идентификатором org_div1:

<div><h1>Привет!</h1></div>
<div id="org_div1">Текст выше сгенерирован автоматически.</div>

document.body.onload = addElement;
var my_div = (newDiv = null);
function addElement() {
 // Создаём новый элемент div
 // и добавляем в него немного контента
 var newDiv = document.createElement("div");
 newDiv.innerHTML = "<h1>Привет!</h1>";
 // Добавляем только что созданный элемент в дерево DOM
 my_div = document.getElementById("org_div1");
 document.body.insertBefore(newDiv, my_div);
}

Примечания

Если существуют атрибуты со значениями по умолчанию, атрибуты узлов предоставляющие их создаются автоматически и применяются к элементу.

Для создания элементов с заданным пространством имён используйте метод createElementNS.

Реализация createElement в Gecko не соответствует DOM спецификации для XUL и XHTML документов: localName и namespaceURI не устанавливаются в null в созданном документе. Смотрите Firefox bug 280692 для подробностей.

Для обратной совместимости с предыдущими версиями спецификации пользовательских элементов некоторые браузеры позволяют передавать здесь строку вместо объекта, где значением строки является имя тега пользовательского элемента.

Спецификации

Совместимость с браузерами

Смотрите также

• Node.removeChild()
• Node.replaceChild()
• Node.appendChild()
• Node.insertBefore()
• Node.hasChildNodes()
• document.createElementNS()