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

HTML DOM insertAdjacentElement() 方法

Objeto Elemento do HTML DOM

insertAdjacentElement()方法将一个给定的元素节点插入到相对于被调用的元素的给定的一个位置。

语法:

element.insertAdjacentElement(position, element)
var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h",2")[0];
head.insertAdjacentElement("afterend", span);
Teste e Veja‹/›

浏览器兼容性

表格中的数字指定了完全支持insertAdjacentElement()方法的第一个浏览器版本:

Method
insertAdjacentElement()488

参数值

参数描述
position相对于元素的位置。
合法值:
  • “afterbegin”-元素开始后(作为第一个子元素)

  • “afterend”-元素之后

  • “beforebegin”-元素之前

  • “Before end”-元素结束之前(作为最后一个子元素)

element您要插入的元素

技术细节

返回值:插入的元素;如果插入失败,则返回null
例外情况:
  • SyntaxError-指定的位置不是可识别的值

  • TypeError-指定的元素不是有效的元素

更多实例

使用“beginbegin”值:

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h",2")[0];
head.insertAdjacentElement("afterbegin", span);
Teste e Veja‹/›

Usando o valor "beforebegin":

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h",2")[0];
head.insertAdjacentElement("beforebegin", span);
Teste e Veja‹/›

Usando o valor "beforeend":

var span = document.getElementsByTagName("span")[0];
var head = document.getElementsByTagName("h",2")[0];
head.insertAdjacentElement("beforeend", span);
Teste e Veja‹/›

Referências Relacionadas

Referência do HTML DOM:elementMétodo .insertAdjacentHTML()

Referência do HTML DOM:elementMétodo .insertAdjacentText()

Referência do HTML DOM:nodeMétodo .insertBefore()

Referência do HTML DOM:nodeMétodo .appendChild()

Objeto Elemento do HTML DOM