Represents a single style sheet in the document.
Members Table
The following table lists the members exposed by the
styleSheet
object.
Attributes/Properties
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. |
Collections
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. |
Methods
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. |
Objects
Object | Description |
---|
page |
Represents an @page rule within a styleSheet. |
Styles
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.
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