دالة importNode() الخاصة بـ XML DOM

دليل مرجعي لـ Document

التعريف والاستخدام

يستخدم دالة importNode() لنسخ عقدة من مستند آخر إلى هذا المستند للاستخدام.

النحو:

importNode(العقدة المستوردة,عميق)
المعامل وصف
العقدة المستوردة العقدة التي سيتم استيرادها
عميق إذا كان القيمة true، فإنه يجب نسخ جميع الأبناء للعقدة المستوردة بشكل متكرر.

النتيجة

العقدة المستوردة نسخة (قد تكون أبناءها أيضًا) وتعيين خاصية ownerDocument الخاصة بها إلى هذا المستند.

يُقفز

إذا العقدة المستوردة هي عقدة Document أو عقدة DocumentType، فإن هذه الطريقة ستقوم بإطلاق استثنائية NOT_SUPPORTED_ERR. استثنائية DOMException، لأن لا يمكن استيراد هذا النوع من العقد.

شرح

المعامل هو عقدة معرف في مستند آخر، والنتيجة هي نسخة من العقدة مناسبة للإدراج في هذا المستند. إذا عميق إذا كان القيمة true، فإنه يجب نسخ جميع الأبناء للعقدة أيضًا. على أي حال، لن يتم تعديل العقدة أو أبنائها.

يتم تعيين خاصية ownerDocument للنسخة المقدمة إلى المستند الحالي، ولكن خاصية parentNode ستكون null لأنها لم تُدرج في المستند بعد. لن يتم نسخ الوظائف المُسجلة للاستماع إلى الأحداث في العقدة الأصلية أو الشجرة.

عند استيراد عقدة Element، سيتم استيراد فقط الخصائص المحددة مسبقًا في المستند المصدر. عند استيراد عقدة Attr، سيتم تلقائيًا تعيين خاصية specified الخاصة بها إلى true.

الرجوع

Node.cloneNode()

دليل مرجعي لـ Document