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

مفهوم JavaScript

دليل JavaScript

دليل JS DOM

طريقة insertAdjacentElement() في HTML DOM

مجموعة الأدوات Element لـ 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

قيمة الم 参数

الم 参数الوصف
الوضعالموقع بالنسبة للعنصر.
القيم الصالحة:

  • ـ "بعد بدء" - بعد بدء العنصر (كأول عنصر فرعي)

  • ـ "بعد نهاية" - بعد العنصر

  • ـ "قبل بدء" - قبل العنصر

  • ـ "قبل نهاية" - قبل نهاية العنصر (كآخر عنصر فرعي)

النقطةالعنصر الذي تريد إدراجه

تفاصيل تقنية

القيمة المُرجعة:العنصر المُدرج؛ إذا فشل الت插入، يتم العودة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النقطةطريقة .insertAdjacentHTML()

مرجع HTML DOMالنقطةطريقة .insertAdjacentText()

مرجع HTML DOMالنقطةطريقة .insertBefore()

مرجع HTML DOMالنقطةطريقة .appendChild()

مجموعة الأدوات Element لـ HTML DOM

مجموعة الأدوات History لـ JavaScriptمجموعة الأدوات Element لـ HTML DOM