واسط های DOM ،Style Sheet سطح 2 مبنای واسط های استفاده شده در ارايهی هر نوع شيوه نامه می باشند. انتظار می رود كه ماژول های DOM آن كه ويژگی های ارايه شدهی زبان شيوه نامه را دارا است توانایی در بر گرفتن واسط هایی كه از آن مشتق می شوند را مطابق اين واسط ها داشته باشند.
ايجاد واسط ها در داخل اين قسمت الزامی نيستند. يك برنامهی كاربردی
DOM می تواند طرح دار (طرح، متن) روش DOMImplementation
واسط را با مقادير پارامتر "StyleSheets" و "2.0"
(به ترتيب) تعيين نمايد در هر صورت اين ماژول با تحقق پذيری پشتيبانی شده است. به
ترتيب كاملا اين ماژول را پشتيبانی نمايد، همچنين می بايستی تحقق پذيری "هستهی"
طرح معين شده در خصوصيات هستهی DOM سطح 2 را پشتيبانی
كند [DOM Level 2 Core]. لطفا به اطلاعات بيشتر راجع
به
تطبيق در DOM سطح 2 [DOM Level 2
Core] رجوع نماييد.
اين واسط های قرار داده شده ايدهی عمومی شيوه نامه ها را به نمايش می گذارند.
واسط StyleSheet
رابط چكيدهی مبنا برای هر نوع شيوه نامه می باشد.
آن وابستگی يك شيوه نامه با يك سند ساختاری را نمايش می دهد. در
HTML، واسط StyleSheet هم يك شيوه نامهی خارجی
را توسط عنصر
LINK متعلق به HTML نمايش می دهد و يا يك
عنصر
STYLE درون برنامه ای را شامل می شود. در XML،
اين واسط يك شيوه نامهی خارجی را از طريق قرار دادن يك
دستورالعمل شيوه
نامه نشان می دهد.
// Introduced in DOM Level 2: interface StyleSheet { readonly attribute DOMString type; attribute boolean disabled; readonly attribute Node ownerNode; readonly attribute StyleSheet parentStyleSheet; readonly attribute DOMString href; readonly attribute DOMString title; readonly attribute MediaList media; };
disabled
از نوع
boolean
false
اگر شيوه نامه كاربردی در سند باشد. true
اگر
اينطور نيست. با اصلاح اين ويژگی ممكن است درجه وضوح جديدی از سبك برای سند ايجاد
شود. اگر هر دو تعريف مناسبی برای مشخصات فعلی است و ويژگی معلول كاذب است،
stylesheet تنها درخواست می شود. بنابراين، اگر رسانه ها
در مرورگر موجود اجرا نمی شوند، ويژگی disabled
می باشد كه ناديده
گرفته شده است.href
از نوع
DOMString
، فقط خواندنی null
است. . برای
عنصر LINK
در HTML 4.0 تعريف
ويژگی href و ويژگی كاذب href را برای
XML در
دستورالعمل پردازش شيوه نامه ببينيد.media
از نوع MediaList
، فقط
خواندنیownerNode
تعيين شده اند. اگر رسانه ای قبلا مشخص نشده باشد MediaList
خالی خواهد بود. برای عنصر LINK
در HTML 4.0
تعريف ويژگی رسانه ها و ويژگی كاذب رسانه ها را برای XML در
دستور العمل پردازش شيوه نامه ببينيد. اصلاح ليست رسانه ها ممكن است باعث تغيير
در ويژگی
disabled
گردد.ownerNode
از نوع Node
،
فقط خواندنیLINK
ياعنصر
STYLE
باشد. برای XML، می تواند دستور العمل پردازش بهم پيوستگی
باشد. برای شيوه نامه هایی كه با ديگر شيوه نامه ها در بر گرفته شده اند، مقدار اين
ويژگی
null
است.parentStyleSheet
از نوع StyleSheet
، فقط
خواندنیnull
است.title
از نوع
DOMString
، فقط خواندنیownerNode
تعيين شده است. See the
تعريف ويژگی عنوان برای عنصر لينك LINK
در HTML 4.0 و عنوان ويژگی كاذب برای
دستور العمل پردازش شيوه نامه XML را ببينيد.type
از نوع
DOMString
، فقط خواندنیownerNode
تعيين شده است. همچنين
مشخصات ويژگی نوع را برای عنصر LINK
در HTML 4.0 و نوع ويژگی كاذب را برای
دستور العمل
پردازش شيوه نامه در XML ببينيد.StyleSheetList
انتزاع يك جمع آوری مرتب برای شيوه نامه ها را
ميسر می سازد.
آيتم ها در StyleSheetList
با در دسترس بودن يك فهرست
صحيح، از 0 شروع می شوند.
// Introduced in DOM Level 2: interface StyleSheetList { readonly attribute unsigned long length; StyleSheet item(in unsigned long index); };
length
از نوع
unsigned long
، فقط خواندنیStyleSheets
در ليست. دامنهی مقدار ركورد شاخص های stylesheet است
كه
0
تا length-1
را شامل می شود.item
null
برمی گردد.index
از نوع
unsigned long
شيوه نامه در موقعيت |
واسط MediaList
جمع آوری مرتب
رسانه
را ميسر می سازد, بدون تعيين يا تحميل كيفيت اين جمع آوری را تكميل می كند. ليست
خالی مشابه ليستی از آن است كه شامل متوسط "all
" می باشد.
آيتم ها در MediaList
با در دسترس بودن يك فهرست صحيح، از 0 شروع
می شوند.
// Introduced in DOM Level 2: interface MediaList { attribute DOMString mediaText; // raises(DOMException) on setting readonly attribute unsigned long length; DOMString item(in unsigned long index); void deleteMedium(in DOMString oldMedium) raises(DOMException); void appendMedium(in DOMString newMedium) raises(DOMException); };
length
از نوع
unsigned long
، فقط خواندنیlength-1
را شامل می شود.mediaText
از نوع
DOMString
|
SYNTAX_ERR: برجسته شده اگر مقدار رشته ای كه معين شده خطای نحوی دارد و تجزيه نشده است. NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست رسانه ها تنها خوانده می شود. |
appendMedium
newMedium
به انتهای ليست. اگر newMedium
قبل از اين استفاده شده، نخست برداشته شده است.
newMedium
از نوع
DOMString
|
INVALID_CHARACTER_ERR: اگر شامل كاراكترهای بی اعتبار واسطهی آن در زير سبك زبان هستند. NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست تنها خوانده می شود. |
deleteMedium
oldMedium
نشان می دهد.
oldMedium
از نوع
DOMString
|
NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست تنها خوانده می شود. NOT_FOUND_ERR: برجسته شده اگر |
item
index
th در ليست. اگر index
بزرگتر يا مساوی با شمارهی رسانه در ليست باشد، اين به null
بر
می گردد.index
از نوع
unsigned long
|
واسطهی |
واسط LinkStyle
مكانيزمی را فراهم می نمايد كه شيوه نامه بتواند
بواسطهی اتصال عهده دار بازيابی پيوندهای داخل سند آن گردد. نمونه ای از واسط
LinkStyle
روشهای ريخته گی اتصال ويژه بر روی نمونه ای از يك اتصال
پيوندی را فراهم می نمايد
(HTMLLinkElement
، HTMLStyleElement
يا
ProcessingInstruction
در DOM سطح 2).
// Introduced in DOM Level 2: interface LinkStyle { readonly attribute StyleSheet sheet; };
sheet
از نوع StyleSheet
، فقط
خواندنیتهيهی مكانيزم واسط DocumentStyle
كه با شيوه نامه ها در سند
جاسازی شده، می تواند بازيافت شود. انتظار می رود كه نمونه ای از واسط DocumentStyle
بتواند با استفاده از روشهای ريخته گی اتصال ويژه بر روی نمونه ای از واسط Document
را فراهم نمايد.
// Introduced in DOM Level 2: interface DocumentStyle { readonly attribute StyleSheetList styleSheets; };
styleSheets
از نوع StyleSheetList
،
فقط خواندنیHTMLLinkElement
را در [DOM
سطح 2 HTML] و [HTML4.0] ببينيد). شيوه نامهی
ذيل می تواند پس از عنصر مندرج در داخل سند و نيز href و
نوع ويژگی ای كه دستگاه داشته ايجاد شود تا اندازه ای كه تعيين كنندهی عنصر
پيوندی يك شيوه نامهی آن باشد.HTMLStyleElement
را در [DOM
سطح 2 HTML] و [HTML4.0] ببینید).شیوه نامهی
ذیل می تواند پس از عنصر مندرج در داخل سند و نوع ویژگی ای که دستگاه داشته ایجاد
شود تا اندازه ای که عنصر مطابق یک زبان شیوه نامه توسط عامل کاربری تفسیر شود.Please report errors in this Translation to the http://lists.w3.org/Archives/Public/w3c-translators or to yoursite2web@gmail.com
لطفا خطاهای موجود در این ترجمه را به http://lists.w3.org/Archives/Public/w3c-translators و یا به yoursite2web@gmail.com گزارش دهید.