13 نوامبر 2000

1. سند مدل شیء Style Sheets

ويراستارها
كريس ويلسن از Microsoft Corp.
فيليپ لی هگرت از W3C
ويدر آپريو از Netscape Communications Corp.

جدول محتويات

1.1. مقدمه

واسط های DOM ،Style Sheet سطح 2 مبنای واسط های استفاده شده در ارايه‌ی هر نوع شيوه نامه می باشند. انتظار می رود كه ماژول های DOM آن كه ويژگی های ارايه شده‌ی زبان شيوه نامه را دارا است توانایی در بر گرفتن واسط هایی كه از آن مشتق می شوند را مطابق اين واسط ها داشته باشند.

ايجاد واسط ها در داخل اين قسمت الزامی نيستند. يك برنامه‌ی كاربردی DOM می تواند طرح دار (طرح، متن) روش DOMImplementation واسط را با مقادير پارامتر "StyleSheets" و "2.0" (به ترتيب) تعيين نمايد در هر صورت اين ماژول با تحقق پذيری پشتيبانی شده است. به ترتيب كاملا اين ماژول را پشتيبانی نمايد، همچنين می بايستی تحقق پذيری "هسته‌ی" طرح معين شده در خصوصيات هسته‌ی DOM سطح 2 را پشتيبانی كند [DOM Level 2 Core]. لطفا به اطلاعات بيشتر راجع به تطبيق در DOM سطح 2 [DOM Level 2 Core] رجوع نماييد.

1.2. واسط های شيوه نامه

اين واسط های قرار داده شده ايده‌ی عمومی شيوه نامه ها را به نمايش می گذارند.

واسط  StyleSheet (معرفی شده در DOM سطح 2)

واسط StyleSheet رابط چكيده‌ی مبنا برای هر نوع شيوه نامه می باشد. آن وابستگی يك شيوه نامه با يك سند ساختاری را نمايش می دهد. در HTML، واسط StyleSheet هم يك شيوه نامه‌ی خارجی را توسط عنصر LINK متعلق به HTML نمايش می دهد و يا يك عنصر STYLE درون برنامه ای را شامل می شود. در XML، اين واسط يك شيوه نامه‌ی خارجی را از طريق قرار دادن يك دستورالعمل شيوه نامه نشان می دهد.


 تعريف IDL
// 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، فقط خواندنی
ارتباطی كه اين شيوه نامه با سند مرتبط می كند. برای HTML, اين می تواند مترادف با  LINK ياعنصر STYLE  باشد. برای XML، می تواند دستور العمل پردازش بهم پيوستگی باشد. برای شيوه نامه هایی كه با ديگر شيوه نامه ها در بر گرفته شده اند، مقدار اين ويژگی null است.
parentStyleSheet از نوع StyleSheet، فقط خواندنی
زبانهای شيوه نامه برای اينكه از مفهوم گنجايش شيوه نامه پشتيبانی كنند، اين ويژگی شيوه نامه نمی تواند در بر دارنده‌ی پشتيبانی باشد، مقدار اين ويژگی null است.
title از نوع DOMString، فقط خواندنی
عنوان مشورتی. غالبا عنوان در ownerNode تعيين شده است. See the تعريف ويژگی عنوان برای عنصر لينك LINK در HTML 4.0 و عنوان ويژگی كاذب برای دستور العمل پردازش شيوه نامه XML را ببينيد.
type از نوع DOMString، فقط خواندنی
اين زبان شيوه نامه را برای اين شيوه نامه تعيين می نمايد. زبان شيوه نامه برای نوع محتوا با (مثال: "text/css") مشخص شده است. نوع محتوا غالبا در ownerNode تعيين شده است. همچنين مشخصات ويژگی نوع را برای عنصر LINK در HTML 4.0 و نوع ويژگی كاذب را برای دستور العمل پردازش شيوه نامه در XML ببينيد.
واسط  StyleSheetList (معرفی شده در DOM سطح 2)
واسط StyleSheetList انتزاع يك جمع آوری مرتب برای شيوه نامه ها را ميسر می سازد.

آيتم ها در StyleSheetList با در دسترس بودن يك فهرست صحيح، از 0 شروع می شوند.


مشخصات IDL
// 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
فهرست درونی جمع آوری
Return Value

StyleSheet

 شيوه نامه در موقعيت index در StyleSheetList يا null است در صورتی كه فهرست آن معتبر نمی باشد..

بدون استثنا
واسط MediaList (معرفی شده در DOM سطح 2)

واسط MediaList جمع آوری مرتب رسانه را ميسر می سازد, بدون تعيين يا تحميل كيفيت اين جمع آوری را تكميل می كند. ليست خالی مشابه ليستی از آن است كه شامل متوسط "all" می باشد.

آيتم ها در MediaList با در دسترس بودن يك فهرست صحيح، از 0 شروع می شوند.


 تعريف IDL
// 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، فقط خواندنی
شماره‌ی رسانه ها در ليست. دامنه‌ی مقدار رسانه ها 0 تا length-1 را شامل می شود.
mediaText از نوع DOMString
تجزيه‌ی متنی نمايش ليست رسانه ها. اين ويرگول جدا شده‌ی ليست رسانه ها است.
استثنا بر روی تنظيمات

DOMException

SYNTAX_ERR: برجسته شده اگر مقدار رشته ای كه معين شده خطای نحوی دارد و تجزيه نشده است.

NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست رسانه ها تنها خوانده می شود.

روش ها
appendMedium
افزودنهای متوسط newMedium به انتهای ليست. اگر newMedium قبل از اين استفاده شده، نخست برداشته شده است.
پارامترها
newMedium از نوع DOMString
واسطه‌ی جديد اضافه شونده.
استثناها

DOMException

INVALID_CHARACTER_ERR: اگر شامل كاراكترهای بی اعتبار واسطه‌ی آن در زير سبك زبان هستند.

NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست تنها خوانده می شود.

مقدار بدون برگشت
deleteMedium
حذف متوسط را از لیست توسط oldMedium نشان می دهد.
پارامترها
oldMedium از نوع DOMString
واسطه جهت حذف در ليست رسانه ها.
استثناها

DOMException

NO_MODIFICATION_ALLOWED_ERR: برجسته شده اگر اين ليست تنها خوانده می شود.

NOT_FOUND_ERR: برجسته شده اگر oldMedium در ليست نيست.

بدون مقدار برگشت
item
برگشتهای indexth در ليست. اگر index بزرگتر يا مساوی با شماره‌ی رسانه در ليست باشد، اين به null بر می گردد.
پارامترها
index از نوع unsigned long
جمع آوری درون فهرست.
مقدار برگشت

DOMString

واسطه‌ی indexth در وضعيت MediaList يا null  می باشد در صورتی كه يك فهرست معتبر وجود ندارد.

بدون استثناها

1.3. اضافات سند

واسط LinkStyle (معرفی شده در DOM سطح 2)

واسط LinkStyle مكانيزمی را فراهم می نمايد كه شيوه نامه بتواند بواسطه‌ی اتصال عهده دار بازيابی پيوندهای داخل سند آن گردد. نمونه ای از واسط LinkStyle روشهای ريخته گی اتصال ويژه بر روی نمونه ای از يك اتصال پيوندی را فراهم می نمايد (HTMLLinkElement، HTMLStyleElement يا ProcessingInstruction در DOM سطح 2).


تعريف IDL
// Introduced in DOM Level 2:
interface LinkStyle {
  readonly attribute StyleSheet       sheet;
};

صفات
sheet از نوع StyleSheet، فقط خواندنی
شيوه نامه.
واسط DocumentStyle (معرفی شده در DOM سطح 2)

تهيه‌ی مكانيزم واسط DocumentStyle كه با شيوه نامه ها در سند جاسازی شده، می تواند بازيافت شود. انتظار می رود كه نمونه ای از واسط DocumentStyle بتواند با استفاده از روشهای ريخته گی اتصال ويژه بر روی نمونه ای از واسط Document را فراهم نمايد.


 تعريف IDL
// Introduced in DOM Level 2:
interface DocumentStyle {
  readonly attribute StyleSheetList   styleSheets;
};

صفات
styleSheets از نوع StyleSheetList، فقط خواندنی
يك ليست شامل تمام شيوه نامه های صريح پيوند داده شده در داخل يا جاسازی شده در سند است. برای اسناد HTML، اين شامل شيوه نامه های خارجی قرار داده شده در داخل عنصر LINK متعلق به HTML و عناصر درون خطی  STYLE است. در XML، اين شامل شيوه نامه های خارجی قرار داده شده توسط دستور العمل های پردازش شيوه نامه ها می باشد ([XML-StyleSheet] را ببينيد).

1.4. پيوستگی ميان يك شيوه نامه و يك سند

HTML و ايجاد شيوه نامه
يك شيوه نامه می تواند وابسته به يك سند HTML در يكی از اين دو شيوه باشد:
  • با ايجاد يك عنصر LINK HTML  (واسط HTMLLinkElement را در  [DOM سطح 2 HTML] و [HTML4.0] ببينيد). شيوه نامه‌ی ذيل می تواند پس از عنصر مندرج در داخل سند و نيز href و نوع ويژگی ای كه دستگاه داشته ايجاد شود تا اندازه ای كه تعيين كننده‌ی عنصر پيوندی يك شيوه نامه‌ی آن باشد.
  • با ایجاد یک عنصر جدید STYLE HTML (واسط HTMLStyleElement را در [DOM سطح 2 HTML] و [HTML4.0] ببینید).شیوه نامه‌ی ذیل می تواند پس از عنصر مندرج در داخل سند و نوع ویژگی ای که دستگاه داشته ایجاد شود تا اندازه ای که عنصر مطابق یک زبان شیوه نامه توسط عامل کاربری تفسیر شود.
HTML و تفکیک شیوه نامه
یک عنصر LINK HTML یا یک عنصر STYLE HTML قرار گرفته در زیر شیوه نامه مطابق جمع آوری شیوه نامه وابسته به یک سند برداشته می شود. مخصوصا، شیوه نامه‌ی برداشته شده در ارایه‌ی سند غیر طولانی بکار برده می شود.
XML و ایجاد شیوه نامه
یک شیوه نامه جدید می تواند ایجاد شده و با ایجاد کردن یک دستور العمل پردازش با نشان [xml-stylesheet] ا XML-StyleSheet و جا دادن آن در داخل سند، وابسته به سند XML باشد.
XML و تفکیک شیوه نامه
برداشتن یک دستور العمل پردازش با یک نشان [xml-stylesheet] ا XML-StyleSheet که در زیر شیوه نامه قرار گرفته مطابق جمع آوری وابسته یک سند برداشته می شود. به ویژه شیوه نامه‌ی برداشته شده در ارایه‌ی سند غیر طولانی بکار برده می شود.
 

 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 گزارش دهید.