Back to Content

Document: enableStyleSheetsForSet() method

files/en-us/web/api/document/enablestylesheetsforset/index.md

latest1.5 KB
Original Source

{{APIRef("DOM")}}{{deprecated_header}}{{Non-standard_header}}

Enables the style sheets matching the specified name in the current style sheet set, and disables all other style sheets (except those without a title, which are always enabled).

Syntax

js-nolint
enableStyleSheetsForSet(name)

Parameters

  • name
    • : The name of the style sheets to enable. All style sheets with a title that match this name will be enabled, while all others that have a title will be disabled. Specify an empty string for the name parameter to disable all alternate and preferred style sheets (but not the persistent style sheets; that is, those with no title attribute).

Return value

None ({{jsxref("undefined")}}).

Notes

  • Title matches are case-sensitive.
  • Calling this method with a null name has no effect; if you want to disable all alternate and preferred style sheets, you must pass "", the empty string.
  • Stylesheets that don't have a title are never affected by this method.
  • This method never affects the values of {{domxref("document.lastStyleSheetSet")}} or {{domxref("document.preferredStyleSheetSet")}}.

Examples

js
document.enableStyleSheetsForSet("Some style sheet set name");

Specifications

Not part of any specification.

Browser compatibility

{{Compat}}

See also

  • {{domxref("Stylesheet")}}
  • {{domxref("Document.styleSheets")}}
  • {{domxref("document.lastStyleSheetSet")}}
  • {{domxref("document.preferredStyleSheetSet")}}
  • {{domxref("document.selectedStyleSheetSet")}}