nsIStyleSheetService

Allows extensions or embeddors to add to the built-in list of user or agent style sheets.

Please add a summary to this article.
  Last changed in Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)

Inherits from: nsISupports

Implemented by: @mozilla.org/content/style-sheet-service;1. To create an instance, use:

var styleSheetService = Components.classes["@mozilla.org/content/style-sheet-service;1"]
                        .getService(Components.interfaces.nsIStyleSheetService);

Method overview

void loadAndRegisterSheet(in nsIURI sheetURI, in unsigned long type);
boolean sheetRegistered(in nsIURI sheetURI, in unsigned long type);
void unregisterSheet(in nsIURI sheetURI, in unsigned long type);

Constants

Constant Value Description
AGENT_SHEET 0  
USER_SHEET 1  
AUTHOR_SHEET 2  

Methods

loadAndRegisterSheet()

Synchronously loads a style sheet from sheetURI and adds it to the list of user or agent style sheets.

A user sheet loaded via this API will come before userContent.css and userChrome.css in the cascade (so the rules in it will have lower precedence than rules in those sheets).

An agent sheet loaded via this API will come after ua.css in the cascade (so the rules in it will have higher precedence than rules in ua.css).

The relative ordering of two user or two agent sheets loaded via this API is undefined.

Sheets added via this API take effect on all documents, including already-loaded ones, immediately.

void loadAndRegisterSheet(
  in nsIURI sheetURI,
  in unsigned long type
);
Parameters
sheetURI
URI of the stylesheet to load and register.
type
One of the type constants.

sheetRegistered()

Check if a stylesheet has been registered

boolean sheetRegistered(
  in nsIURI sheetURI,
  in unsigned long type
);
Parameters
sheetURI
URI of the stylesheet to check.
type
One of the type constants.
Return value

Returns true if a style sheet at sheetURI has previously been added to the list of style sheets specified by type.

unregisterSheet()

Remove the style sheet at sheetURI from the list of style sheets specified by type. The removal takes effect immediately, even for already-loaded documents.

void unregisterSheet(
  in nsIURI sheetURI,
  in unsigned long type
);
Parameters
sheetURI
URI of the stylesheet to unregister.
type
One of the type constants.

See also

Document Tags and Contributors

Contributors to this page: Sheppy, Nickolay, Ted_Mielczarek, MKaply, trevorh
Last updated by: Sheppy,