عرض مصدر JavaScript/Document/adoptNode

<noinclude>{{DISPLAYTITLE:<code>Document.adoptNode()</code>}}</noinclude>

يتبنّى هذا التّابع عقدة خارجيّة، وتُحذف العقدة وشجرتها الفرعيّة من المُستند الأصلي (إن كان موجودا)، وتتغيّر قيمة المُستند المالِك <code>[[JavaScript/Node/ownerDocument|ownerDocument]]</code> إلى المُستند الحاليّ. ويُمكن بعد ذلك إدخال العقدة إلى المُستند الحاليّ.

==البنية العامة==
<syntaxhighlight lang="javascript">
node = document.adoptNode(externalNode);  
</syntaxhighlight>
*<code>node</code>
: يُمثّل العقدة المُتبنّاة والتي مالِكها هو المُستند الحالي.وعقدتها الأب <code>[[JavaScript/Node/parentNode|parentNode]]</code>  ذات قيمةٍ null، وذلك لأنّها لم تُدخَل بعدُ إلى شجرة المُستند. لاحِظ أنّ كلّا من node وexternalNode سيُصبحان نفس الكائن بعد الاستدعاء.

*<code>externalNode</code>
: هي العقدة التي ستُتبنّى من مُستند آخر.

==مثال==
<syntaxhighlight lang="javascript">
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]));
}
</syntaxhighlight>
==ملاحظات==
يُمكن لاستدعاء adoptNode أن يفشل بسبب قدوم العقدة الأصل من تطبيق آخر، لكنّ هذا لا يكون مُشكلة في الغالب مع تطبيقات المُتصفّحات.

يجب نسخ العقد من المُستندات الخارجيّة باستخدام التّابع  document.importNode()‎ أو تبنّيها بالتّابع document.adoptNode()‎ قبل إمكان إدخالها إلى المُستند الحاليّ. للاستزادة حول مشاكل <code>[[JavaScript/Node/ownerDocument|ownerDocument]]</code> انظر  الأسئلة الشّائعة على [http://www.w3.org/DOM/faq.html#ownerdoc W3C DOM].

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

==انظر أيضًا==
*  <code>[[JavaScript/Document/importNode|document.importNode]]</code>

==مصادر ومواصفات==
* مواصفة [http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode 
    DOM Level 3 Core: Document.adoptNode]

[[تصنيف:JavaScript]]
[[تصنيف:Web API]]
[[تصنيف:DOM]]
[[تصنيف:Document]]