[This documentation is preliminary and is subject to change.]
Gets or sets information used to bind the value of a content attribute of a meta element to an HTTP response header.
 |
Syntax
| HTML | <element http-equiv="p" ... > |
|---|---|
| JavaScript | |
Property values
Type: String
the information in the response header. See HTTP Response Headers for a list of possible values.
Standards information
- Document Object Model (DOM) Level 1 Specification, Section 2.5.5
- HTML 4.01 Specification, Section 7.4.4
Remarks
If the property is omitted, the name property should be used to identify the meta-information. The httpEquiv property is not case-sensitive.
Developers using the httpEquiv and content attributes to refresh documents from alternate URLs should treat the value of content as untrusted data. For more information, please see Security Considerations: Dynamic HTML.
As of Windows Internet Explorer 8, the httpEquiv attribute also supports a value of x-ua-compatible, which allows developers to specify the document compatibility mode that Windows Internet Explorer should use to display a webpage. To do this, set the content attribute to a String value containing a comma-delimited list of one or more of the following values.
| Value | Description |
IE=9 | The webpage is displayed in IE9 Standards mode. |
IE=8 | The webpage is displayed in IE8 Standards mode. |
IE=7 | The webpage is displayed in IE7 Standards mode. |
IE=5 | The webpage is displayed in IE5 (Quirks) mode. |
IE=EmulateIE9 | If the webpage specifies a standards-based doctype directive, the page is displayed in IE9 mode; otherwise, it is displayed in IE5 mode. |
IE=EmulateIE8 | If the webpage specifies a standards-based doctype directive, the page is displayed in IE8 mode; otherwise, it is displayed in IE5 mode. |
IE=EmulateIE7 | If the webpage specifies a standards-based doctype directive, the page is displayed in IE7 mode; otherwise, it is displayed in IE5 mode. |
IE=Edge | The webpage is displayed in the highest mode available to the version of Internet Explorer used to view the page. This option is generally intended for testing purposes. |
When the content attribute specifies multiple document modes, Internet Explorer displays the page in the highest mode supported by the browser. For more information, see Defining Document Compatibility.
Examples
This example causes the browser to reload the document every two seconds.
<meta http-equiv="refresh" content="2">
This example sets the character set for the document.
<meta http-equiv="Content-Type"
content="text/html; charset=utf-8">
This example disables theme support for the document.
<meta http-equiv="msthemecompatible" content="no">
This example tells Internet Explorer to display a webpage in IE9 mode, if possible.
<meta http-equiv="X-UA-Compatible" content="IE=9">
See also
- Reference
- content
- meta
- Conceptual
- Defining Document Compatibility
Build date: 3/8/2012
