document.createElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

* Some parts of this feature may have varying levels of support.

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

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

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

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

Параметры

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

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

Пример

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

html

<div><h1>Привет!</h1></div><div>Текст выше сгенерирован автоматически.</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 для подробностей.

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