Skip to content

Commit 4848c99

Browse files
committed
Docs: Improve info regarding IE's document modes
Ref h5bp#1554 Close h5bp#1446
1 parent 4b77438 commit 4848c99

File tree

1 file changed

+38
-19
lines changed

1 file changed

+38
-19
lines changed

doc/html.md

+38-19
Original file line numberDiff line numberDiff line change
@@ -54,33 +54,52 @@ important because:
5454
tags](http://msdn.microsoft.com/en-us/library/cc288325.aspx)
5555

5656

57-
## X-UA-Compatible
57+
### `X-UA-Compatible`
5858

59-
This makes sure the latest version of IE is used in versions of IE that contain
60-
multiple rendering engines. Even if a site visitor is using IE8 or IE9, it's
61-
possible that they're not using the latest rendering engine their browser
62-
contains. To fix this, use:
59+
Internet Explorer 8/9/10 support [document compatibility
60+
modes](http://msdn.microsoft.com/en-us/library/cc288325.aspx) that affect the
61+
way webpages are interpreted and displayed. Because of this, even if your site's
62+
visitor is using, let's say, Internet Explorer 9, it's possible that IE will not
63+
use the latest rendering engine, and instead, decide to render your page using
64+
the Internet Explorer 5.5 rendering engine.
65+
66+
Specifying the `X-UA-Compatible` meta tag:
6367

6468
```html
6569
<meta http-equiv="X-UA-Compatible" content="IE=edge">
6670
```
6771

68-
The `meta` tag tells the IE rendering engine it should use the latest, or edge,
69-
version of the IE rendering environment.
70-
71-
This `meta` tag ensures that anyone browsing your site in IE is treated to the
72-
best possible user experience that their browser can offer.
72+
or sending the page with the following HTTP response header
7373

74-
This line breaks validation. To avoid this edge case issue it is recommended
75-
that you **remove this line and use the
76-
[`.htaccess`](https://github.com/h5bp/server-configs-apache)** (or [other server
77-
config](https://github.com/h5bp/server-configs)) to send these headers instead.
78-
You also might want to read [Validating:
79-
X-UA-Compatible](https://groups.google.com/group/html5boilerplate/browse_thread/thread/6d1b6b152aca8ed2).
74+
```
75+
X-UA-Compatible: IE=edge
76+
```
8077

81-
If you are serving your site on a non-standard port, you will need to set this
82-
header on the server-side. This is because the IE preference option 'Display
83-
intranet sites in Compatibility View' is checked by default.
78+
will force Internet Explorer 8/9/10 to render the webpage in the highest
79+
available mode in [the various cases when it may
80+
not](https://hsivonen.fi/doctype/#ie8), and therefore, ensure that anyone
81+
browsing your site is treated to the best possible user experience that
82+
browser can offer.
83+
84+
If possible, we recommend that you remove the `meta` tag and send only the
85+
HTTP response header as the `meta` tag:
86+
87+
* brakes validation (see also: [Validating
88+
X-UA-Compatible](http://groups.google.com/group/html5boilerplate/browse_thread/thread/6d1b6b152aca8ed2))
89+
* will not always work if your site is served on a non-standard port, as
90+
Internet Explorer's preference option `Display intranet sites in Compatibility
91+
View` is checked by default
92+
93+
If you are using Apache as your webserver, including the
94+
[`.htaccess`](https://github.com/h5bp/server-configs-apache) file takes care of
95+
the HTTP header. If you are using a different server, check out our [other
96+
server config](https://github.com/h5bp/server-configs).
97+
98+
Starting with Internet Explorer 11, [document modes are
99+
deprecated](http://msdn.microsoft.com/en-us/library/ie/bg182625.aspx#docmode).
100+
If your business still relies on older web apps and services that were
101+
designed for older versions of Internet Explorer, you might want to consider
102+
enabling [Enterprise Mode](http://blogs.msdn.com/b/ie/archive/2014/04/02/stay-up-to-date-with-enterprise-mode-for-internet-explorer-11.aspx) throughout your company.
84103

85104

86105
## Mobile viewport

0 commit comments

Comments
 (0)