JavaScript/Document/adoptNode

يتبنّى التّابع Document.adoptNode()‎ عقدة خارجيّة، وتُحذف العقدة وشجرتها الفرعيّة من المُستند الأصلي (إن كان موجودًا)، وتتغيّر قيمة المُستند المالِك ownerDocument إلى المُستند الحاليّ. ويُمكن بعد ذلك إدخال العقدة إلى المُستند الحاليّ.

البنية العامة

node = document.adoptNode(externalNode);

node

يُمثّل العقدة المُتبنّاة والتي مالِكها هو المُستند الحالي وعقدتها الأب parentNode ذات قيمةٍ null، وذلك لأنّها لم تُدخَل بعدُ إلى شجرة المُستند. لاحِظ أنّ كلّا من node وexternalNode سيُصبحان نفس الكائن بعد الاستدعاء.

externalNode

هي العقدة التي ستُتبنّى من مُستند آخر.

مثال

var iframe = document.getElementById('my-iframe');
var iframeImages = iframe.contentDocument.getElementsByTagName('img');

var newParent = document.getElementByTagName('images');

for (var i = 0; i < iframeImages.length; i++) {
    newParent.appendChild(document.adoptNode(iframeImages[i]));
}

ملاحظات

يُمكن لاستدعاء adoptNode أن يفشل بسبب قدوم العقدة الأصل من تطبيق آخر، لكنّ هذا لا يكون مُشكلة في الغالب مع تطبيقات المُتصفّحات.

يجب نسخ العقد من المُستندات الخارجيّة باستخدام التّابع document.importNode()‎ أو تبنّيها بالتّابع document.adoptNode()‎ قبل إمكان إدخالها إلى المُستند الحاليّ. للاستزادة حول مشاكل ownerDocument انظر الأسئلة الشّائعة على W3C DOM.

لا يُلزِم مُتصفّح Firefox على العمل بهذه القاعدة (لأنّ الإلزام بها عطّل بعض المواقع). وإنما يُشجّع مطوّري الويب على إصلاح الشيفرة الخاصّة بهم لاتّباع هذه القاعدة لتوافقيّةٍ مُستقبليّةٍ أفضل.

انظر أيضًا

• document.importNode

مصادر ومواصفات

• مواصفة DOM Level 3 Core: Document.adoptNode