compatMode Property

Internet Development Index

Retrieves a value that indicates whether standards-compliant mode is switched on for the object.

Syntax

[ sMode = ] document.compatMode

Possible Values

sModeString that receives one of the following values.
BackCompatStandards-compliant mode is not switched on.
CSS1CompatStandards-compliant mode is switched on.

The property is read-only. The property has no default value.

Remarks

With Internet Explorer 6 and later, you switch on standards-compliant mode by including the !DOCTYPE declaration at the top of your document, specifying a valid Label in the declaration, and in some cases, specifying the Definition and/or URL. The Label specifies the unique name of the Document Type Definition (DTD), and can be appended with the version number of the DTD. The Definition specifies the definition of the DTD that is specified in the Label. The URL specifies the location of the DTD.

When standards-compliant mode is switched on, Internet Explorer renders the document in compliance with the Cascading Style Sheets (CSS), Level 1 (CSS1) Non-Microsoft link standard. When standards-compliant mode is not switched on, rendering behavior is consistent with previous versions of Internet Explorer.

Examples

The !DOCTYPE declarations in the following examples specify conformance to the Transitional HTML 4.0 DTD. The declaration in the second example specifies the URL of the DTD. The declaration in the first example does not. The second declaration switches on standards-compliant mode with Internet Explorer 6 and later. The first declaration does not.

The compatMode property returns BackCompat with documents containing the declaration in the following example. This declaration does not switch on standards-compliant mode because it does not specify the URL of the Transitional HTML 4.0 DTD.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
This feature requires Microsoft® Internet Explorer 6 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

The compatMode property returns CSS1Compat with documents containing the declaration in the following example. This declaration switches on standards-compliant mode because it specifies the URL of the Transitional HTML 4.0 DTD.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
This feature requires Microsoft® Internet Explorer 6 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

document

See Also

CSS Enhancements in Internet Explorer 6