document.createElement

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

В HTML-документах создает указанный в аргументе элемент или HTMLUnknownElement, если элемент неизвестен.

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

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

Синтаксис

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

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

Примеры

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

<!DOCTYPE html>
<html>
<head>
<title>||Работа с элементами||</title>
</head>

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

<script>
  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);
  }
</script>
</html>

Замечания

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

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

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

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

DOM 2 Core: createElement