Document.enableStyleSheetsForSet()
< JavaScript | Document
يفعّل التّابع Document.enableStyleSheetsForSet()
صفحات الأنماط التي توافق الاسم المُحدّد في مجموعة صفحات الأنماط الحاليّة، ويُعطّل جميع صفحات الأنماط الأخرى (عَدا تلك التي بدون عنوان، والتي تكون دائمًا مُفعّلة).
البنية العامة
document.enableStyleSheetsForSet(name)
name
اسم صفحات الأنماط المرغوب تفعيلها. ستُفعّل جميع صفحات الأنماط التي توافق هذا الاسم، لكن لن تُعطَّل صفحات الأنماط الأخرى التي تملك عنوانًا. مرّر سلسلةً نصيّةً فارغةً لهذا المُعامل لتعطيل جميع صفحات الأنماط البديلة والمُفضّلة (دون صفحات الأنماط الدّائمة التي لا تملك خاصّية title
).
ملاحظات
- تُوافَقُ العناوين يكون حسّاسًا لحالة الأحرف (case-sensitive).
- لا يملِك استدعاء هذا التّابع مع قيمة
null
للمُعاملname
أي تأثير؛ إن أردت تعطيل جميع صفحات الأنماط البديلة والمُفضّلة، فمن الواجب عليك تمرير القيمة""
، أي سلسلةٌ نصيّةٌ فارغة. - صفحات الأنماط بدون عناوين لا تتأثّر أبدًا بهذا التّابع.
- هذا التّابع لا يؤثّر أبدًا على قيم كل من
document.lastStyleSheetSet
أوdocument.preferredStyleSheetSet
.
أمثلة
document.enableStyleSheetsForSet("اسمُ صفحة أنماط مُعيّنة");
مُلاحظة: سيُساعدك هذا المثال على فهم الفرق بين كيفيّة تصرّف التّابع Document.enableStyleSheetsForSet()
وضبط قيمة للخاصيّة document.selectedStyleSheetSet
مُباشرةً.
انظر أيضًا
مصادر ومواصفات
- مواصفة HTML5: Alternate Style Sheets.