WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIDOMNSDocumentStyle

IID:26311d10-7e24-4c7b-bb3d-17aad86f4d88
Inherits From:nsIDOMDocumentStyle

The nsIDOMNSDocumentStyle interface is an extension to the nsIDOMDocumentStyle interface. This interface exposes more ways to interact with style sheets in the Document Object Model. This interface is currently very much experimental.

NOTE: This interface represents the additions to nsIDOMDocumentStyle defined by . The comments here describe our implementation; if those comments don't match that spec, file bugs.

This interface is implemented by the following components:


Properties

readonly DOMString lastStyleSheetSet

readonly DOMString preferredStyleSheetSet

This attribute must return the preferred style sheet set as set by the author. It is determined from the order of style sheet declarations and the Default-Style HTTP headers, as eventually defined elsewhere in the Web Apps 1.0 specification. If there is no preferred style sheet set, this attribute must return the empty string. The case of this attribute must exactly match the case given by the author where the preferred style sheet is specified or implied. This attribute must never return null.

DOMString selectedStyleSheetSet

This attribute indicates which style sheet set is in use. This attribute is live; changing the disabled attribute on style sheets directly will change the value of this attribute.

If all the sheets that are enabled and have a title have the same title (by case-sensitive comparisons) then the value of this attribute must be exactly equal to the title of the first enabled style sheet with a title in the styleSheets list. Otherwise, if style sheets from different sets are enabled, then the return value must be null (there is no way to determine what the currently selected style sheet set is in those conditions). Otherwise, either all style sheets that have a title are disabled, or there are no alternate style sheets, and selectedStyleSheetSet must return the empty string.

Setting this attribute to the null value must have no effect.

Setting this attribute to a non-null value must call enableStyleSheetsForSet() with that value as the function's argument, and set lastStyleSheetSet to that value.

From the DOM's perspective, all views have the same selectedStyleSheetSet. If a UA supports multiple views with different selected alternate style sheets, then this attribute (and the StyleSheet interface's disabled attribute) must return and set the value for the default view.

readonly nsIDOMDOMStringList styleSheetSets

This must return the live list of the currently available style sheet sets. This list is constructed by enumerating all the style sheets for this document available to the implementation, in the order they are listed in the styleSheets attribute, adding the title of each style sheet with a title to the list, avoiding duplicates by dropping titles that match (case-sensitively) titles that have already been added to the list.


Methods

void enableStyleSheetsForSet ( DOMString name )

void enableStyleSheetsForSet ( DOMString name )

Calling this method must change the disabled attribute on each StyleSheet object with a title attribute with a length greater than 0 in the styleSheets attribute, so that all those whose title matches the name argument are enabled, and all others are disabled. Title matches must be case-sensitive. Calling this method with the empty string disables all alternate and preferred style sheets (but does not change the state of persistent style sheets, that is those with no title attribute).

Calling this method with a null value must have no effect.

Style sheets that do not have a title are never affected by this method. This method does not change the values of the lastStyleSheetSet or preferredStyleSheetSet attributes.

Arguments:
name

Reference documentation is generated from Mozilla's source.