disabled Property

Sets or retrieves whether a style sheet is applied to the object.

Syntax

HTML N/A
Scripting object.disabled [ = bDisabled ]

Possible Values

bDisabled Boolean that specifies or receives one of the following values.
false Default. Style sheet is applied to the object.
true Style sheet is not applied to the object.
The property is read/write. The property has a default value of false.
Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

When a style is disabled, none of the rules render.
The value of this property can also change per media-dependent style sheets.
The disabled property applies to the style object, not the STYLE property.

Example

This example uses the disabled property to indicate whether a style sheet is applied to the body element.

<STYLE>
BODY {background-color: #000000; color: #FFFF00;}
</STYLE>
<SCRIPT>
function fnToggle(){
var oStyle=document.styleSheets[0];
if(oStyle.disabled==true){
oStyle.disabled=false;
}
else{
oStyle.disabled=true;
}
}
</SCRIPT>
<BODY>
<P>
Click Toggle Style Sheet to enable/disable
styles applied to the BODY element.
</P>
<P>
<INPUT TYPE="button"
VALUE="Toggle Style Sheet"
onclick="fnToggle()">
</P>
</BODY>

Standards Information

This property is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

LINK, STYLE, styleSheet