English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Объект JavaScript

Справочник JavaScript

JS DOM справочник

Метод insertAdjacentElement() в HTML DOM

Объект элемента HTML DOM

insertAdjacentElement()Метод вставляет заданный узел элемента в заданное положение относительно вызываемого элемента.

Грамматика:

element.insertAdjacentElement(position, element)
var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h2")[0];
head.insertAdjacentElement("afterend", span);
Проверьте, посмотрите‹/›

Совместимость браузеров

Числа в таблице указывают на первую версию браузера, которая полностью поддерживает метод insertAdjacentElement():

Метод
insertAdjacentElement()Да48ДаДа8

Значение параметра

ПараметрОписание
positionПоложение относительно элемента.
Допустимые значения:

  • "afterbegin" - после начала элемента (в качестве первого подэлемента)

  • "afterend" - после элемента

  • "beforebegin" - до элемента

  • "Before end" - до конца элемента (в качестве последнего подэлемента)

elementЭлемент, который вы хотите вставить

Технические детали

Возвратное значение:Вставленный элемент; если вставка не успешна, то возвращаетсяnull.
Исключительные случаи:

  • SyntaxError-Указанное положение не является распознаваемым значением

  • TypeError-Указанный элемент не является эффективным элементом

Более примеров

Использование значения "beginbegin":

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h2")[0];
head.insertAdjacentElement("afterbegin", span);
Проверьте, посмотрите‹/›

Использование значения "beforebegin":

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h2")[0];
head.insertAdjacentElement("beforebegin", span);
Проверьте, посмотрите‹/›

Использование значения "beforeend":

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h2")[0];
head.insertAdjacentElement("beforeend", span);
Проверьте, посмотрите‹/›

См. также

Референс HTML DOM:elementМетод .insertAdjacentHTML()

Референс HTML DOM:elementМетод .insertAdjacentText()

Референс HTML DOM:nodeМетод .insertBefore()

Референс HTML DOM:nodeМетод .appendChild()

Объект элемента HTML DOM

Объект истории JavaScriptОбъект элемента HTML DOM