Node.appendChild

Аннотация

Добавляет элемент в конец списка дочерних элементов родителя. Если элемент уже существует он удаляется из текущего родителя и вставляется заново.

Синтаксис

var child = element.appendChild(child);

• element родительский элемент.
• child это элемент вставляется в конец element.

Описание

Метод appendChild возвращает ссылку на добавленный узел(элемент).

Пример

// Создаем новый элемент параграфа, и вставляем в конец document body
var p = document.createElement("p");
document.body.appendChild(p);

Примечание

Если child ссылается на существующий элемент в документе , тогда appendChild перемещает элемент с его текущей позиции на новую (т.e необязательно удалять элемент из родителя перед тем как перемещать его в другой элемент).

Исходя из этого один и тот же элемент не может находится в нескольких родителях одновременно.

Вы можете использовать Node.cloneNode для копирования элемента перед его перемещением в нового родителя (Копии созданные с помощью cloneNode не синхронизируются автоматически.)

Этот метод не может перемещать элементы между двумя различными документами. Если вы хотите добавить элемент в другой документ (например отобразить результаты AJAX запроса) нужно использовать метод document.importNode.

appendChild() один из основных методов веб программирования с использованием DOM. Метод appendChild() вставляет новый элемент в DOM структуру документа.

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

• DOM Level 3 Core: appendChild

См. также

• Node.removeChild
• Node.replaceChild
• Node.insertBefore
• Node.hasChildNodes