disabled Property

Internet Development Index

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

Syntax

HTMLN/A
Scriptingobject.disabled [ = bDisabled ]

Possible Values

bDisabledBoolean that specifies or receives one of the following values.
falseDefault. Style sheet is applied to the object.
trueStyle 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 Non-Microsoft link.

Applies To

LINK, STYLE, styleSheet

See Also

disabled