روش setAttributeNS() XML DOM

دستورالعمل‌های مورد Element

تعریف و استفاده

روش setAttributeNS() ایجاد یا تغییر ویژگی‌های دارای نام فضایی را انجام می‌دهد.

نحوه استفاده:

elementNode.setAttributeNS(name,value)
پارامترها توضیحات
ns ضروری. URI نام فضایی ویژگی‌ای که قرار است تنظیم شود را مشخص می‌کند.
name ضروری. نام ویژگی‌ای که قرار است تنظیم شود را مشخص می‌کند.
value ضروری. مقدار ویژگی‌ای که قرار است تنظیم شود را مشخص می‌کند.

توضیحات

این روش با روش setAttribute()مانند آن، اما باید ویژگی‌های ایجاد شده یا تنظیم شده توسط URI نام فضایی و نام محلی (که از پیشوند نام فضایی، دو نقطه و نام محلی در نام فضایی تشکیل شده) به طور مشترک مشخص شوند. علاوه بر تغییر مقدار یک ویژگی، استفاده از این روش می‌تواند پیشوند نام فضایی ویژگی را نیز تغییر دهد.

تنها در صورت استفاده از مستندات XML با نام فضایی، از این روش استفاده می‌شود. ممکن است مرورگرهایی که مستندات XML را پشتیبانی نمی‌کنند، این روش را پیاده‌سازی نکنند.

مثال

در تمامی مثال‌ها، ما از فایل XML استفاده خواهیم کرد books_ns.xml، و همچنین توابع JavaScript loadXMLDoc().

مثال 1

کد زیر یک ویژگی "edition" به اولین <book> در "books_ns.xml" اضافه می‌کند:

xmlDoc=loadXMLDoc("books_ns.xml");
x=xmlDoc.getElementsByTagName("book")[0];
ns="http://www.codew3c.com/edition/";
x.setAttributeNS(ns,"edition","first");
document.write(x.getAttributeNS(ns,"edition"));

خروجی:

first

مثال 2

کد زیر تغییرات را در ارزش "lang" ویژگی اولین <title> در "books_ns.xml" اعمال می‌کند:

xmlDoc=loadXMLDoc("books_ns.xml");
x=xmlDoc.getElementsByTagName("title")[0];
ns="http://www.codew3c.com/children/";
x.setAttributeNS(ns,"c:lang","italian");
document.write(x.getAttributeNS(ns,"lang"));

خروجی:

italian

دستورالعمل‌های مورد Element