مетод importNode() XML DOM
تعریف و استفاده
مетод importNode() XML DOM یک گره را از یک مستند دیگر به این مستند کپی می‌کند تا بتوان از آن استفاده کرد.
زبان نویسی:
importNode(موضوع وارد شده,}عمیق)
| پارامتر | توضیح |
|---|---|
| موضوع وارد شده | موضوع وارد شده |
| عمیق | اگر مقدار آن true باشد، فرزندان موضوع وارد شده نیز به صورت تصاعدی کپی می‌شوند. |
بازگشتی
موضوع وارد شده کپی موضوع (ممکن است فرزندان آن نیز باشد) به موضوع فعلی و ویژگی ownerDocument آن به این مستند تنظیم می‌شود.
پرتاب می‌کند
اگر موضوع وارد شده موضوع Document یا موضوع DocumentType است، این روش یک موضوع NOT_SUPPORTED_ERR را پرتاب می‌کند. موضوع DOMException، زیرا نمی‌توان این نوع موضوعات را وارد کرد.
توضیح
این روش موضوع دیگری را که در مستند دیگری تعریف شده است، به عنوان پارامتر می‌گیرد و بازگشتی مناسب برای موضوعی که می‌توان به مستند این وارد کرد، باز می‌گرداند. اگر عمیق اگر مقدار آن true باشد، همه فرزندان موضوع نیز کپی می‌شوند. به هر حال، موضوع اصلی و فرزندان آن تغییر نمی‌کنند.
ویژگی ownerDocument بازگشتی به مستند فعلی تنظیم می‌شود، اما ویژگی parentNode به null است، زیرا هنوز به مستند اضافه نشده است. توابع شنیدار رویداد در موضوع اصلی یا درخت اصلی کپی نمی‌شوند.
وقتی از موضوع Element وارد می‌شود، تنها ویژگی‌هایی که در مستند منبع به صورت واضح تنظیم شده‌اند، وارد می‌شوند. وقتی از موضوع Attr وارد می‌شود، ویژگی specified خود را به صورت خودکار به true تنظیم می‌کند.
