Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.
Общая информация
В 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 для подробностей.