Node.removeChild

Аннотация

Удаляет дочерний элемент из DOM. Возвращает удаленный элемент.

Синтакс

var oldChild = element.removeChild(child);
element.removeChild(child);

• child дочерний элемент который будет удален из DOM.
• element родительский элемент удаляемого child.
• oldChild ссылка на удаляемый дочерний элемент. oldChild === child.

Удаленный дочерний элемент остается в памяти, но больше не является частью DOM. Вы можете повторно использовать удаленный элемент с помощью ссылки на объект - oldChild.

Если child не является дочерним элементом element, тогда метод генерирует исключение. Также это происходит если child является дочерним элементом element во время вызова метода, но был удален во время вызова обработчика событий удаляющего элемент(т.e при удалении элемента непосредственно перед вызовом обработчика событий).

Пример

<!-- Пример -->

<div id="top" align="center">
  <div id="nested"></div>
</div>

// Удаление элемента с известным родителем
var d = document.getElementById("top");
var d_nested = document.getElementById("nested");
var throwawayNode = d.removeChild(d_nested);

// Удаление элемента без указания его родителя
var node = document.getElementById("nested");
if (node.parentNode) {
  node.parentNode.removeChild(node);
}

// Удаление всех дочерних элементов
var element = document.getElementById("top");
while (element.firstChild) {
  element.removeChild(element.firstChild);
}

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

• DOM Level 1 Core: removeChild
• DOM Level 2 Core: removeChild
• DOM Level 3 Core: removeChild

См. также

• Node.replaceChild
• Node.parentNode
• ChildNode.remove