Microsoft Developer Network

Represents a single style sheet in the document.

Members Table

The following table lists the members exposed by the styleSheet object.

Attributes/Properties

Show: Attributes/Properties Collections Methods Objects Styles

Attribute Property Description canHaveHTML Sets or retrieves the value indicating whether the object can contain rich HTML markup. DISABLED disabled Sets or retrieves a value that indicates whether the user can interact with the object. href Sets or retrieves the URL of the linked style sheet. ID id Retrieves the string identifying the object. isContentEditable Gets the value that indicates whether the user can edit the contents of the object. isDisabled Gets the value that indicates whether the user can interact with the object. isMultiLine Retrieves the value indicating whether the content of the object contains one or more lines. owningElement Retrieves the next object in the HTML hierarchy. parentStyleSheet Retrieves the style sheet that imported the current style sheets. readOnly Retrieves whether the rule or style sheet is defined on the page or is imported. TITLE title Sets or retrieves the title of the style sheet. type Retrieves the Cascading Style Sheets (CSS) language in which the style sheet is written. Collection Description imports Retrieves a collection of all the imported style sheets defined for the respective styleSheet object. pages Retrieves a collection of page objects, which represent @page rules in a styleSheet. rules Retrieves a collection of rules defined in a style sheet. Method Description addImport Adds a style sheet to the imports collection for the specified style sheet. addPageRule Creates a new page object for a style sheet. addRule Creates a new rule for a style sheet. fireEvent Fires a specified event on the object. removeImport Removes the imported style sheet from the imports collection based on ordinal position. removeRule Deletes an existing style rule for the styleSheet object, and adjusts the index of the rules collection accordingly. Object Description page Represents an @page rule within a styleSheet. Style attribute Style property Description cssText Sets or retrieves the persisted representation of the style rule. MEDIA media Sets or retrieves the media type. text-autospace textAutospace Sets or retrieves the autospacing and narrow space width adjustment of text.

Remarks

You can use this object to retrieve style sheet information, such as the URL of the source file for the style sheet and the element in the document that owns (defines) the style sheet. You also can use it to modify style sheets.

You can retrieve a styleSheet object from the styleSheets collection or from the imports collection. Each item in these collections is a style sheet. A styleSheet object is available for a style sheet only if it is included in a document with a style or link element, or with an @import statement in a style element.

Example

This example uses the styleSheet object to change the cascading style sheets (CSS) values of inline and imported styles.

<STYLE>
BODY {background-color: #CFCFCF;}
@import url("otherStyleSheet.css");
</STYLE>
<SCRIPT>
window.onload=fnInit;
function fnInit(){
   // Access a rule in the styleSheet, change backgroundColor to blue.
   var oStyleSheet=document.styleSheets[0];
   var oRule=oStyleSheet.rules[0];
   oRule.style.backgroundColor="#0000FF";
   // Add a rule for P elements to have yellow backgrounds.
   oStyleSheet.addRule("P","background-color: #FFFF00;");
   // Change and imported rule:
   oStyleSheet.imports[0].color="#000000";
}
</SCRIPT>

Standards Information

There is no public standard that applies to this object.

Applies To

styleSheets