From 8f0efe6bb5598ea9ba2c875b8f4f57dc931f0616 Mon Sep 17 00:00:00 2001 From: Dan Vanderkam Date: Thu, 4 Dec 2014 09:38:32 -0500 Subject: [PATCH] Update IE instructions --- docs/ie.html | 37 +++++-------------------------------- 1 file changed, 5 insertions(+), 32 deletions(-) diff --git a/docs/ie.html b/docs/ie.html index 0b1233b..49fa80f 100644 --- a/docs/ie.html +++ b/docs/ie.html @@ -10,37 +10,10 @@

When IE9 is in HTML5 mode, dygraphs works just like in other modern browsers.

-

You should seriously consider stopping here! Older versions of IE have a small market share that's decreasing by the day. Major web sites, like the New York Times, have already dropped support for IE8. Future versions of dygraphs will do the same. But if you insist…

- -

If you want to support previous versions of Internet Explorer (IE6–IE8), you'll need to include the excanvas library, which emulates the <canvas> tag using VML. You can add excanvas by including the following snippet:

- -
-<!DOCTYPE html> 
-<html>
-  <head>
-    <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7; IE=EmulateIE9"> 
-    <!--[if IE]><script src="path/to/excanvas.js"></script><![endif]-->
-  </head>
-
- -

(This is surprisingly tricky because the HTML5 doctype breaks excanvas in IE8. See this discussion for details. Note that the <meta http-equiv…> line must appear first in the <head> section for this to work properly.)

- -

While VML emulation sounds like it would be slow, it works well in practice for most charts.

- -

One common gotcha to look out for: make sure you don't have any trailing commas in parameter lists, e.g.

- -
-new Dygraph(el, data, {
-  showRoller: true,  // note trailing comma
-})
- -

Most browsers will ignore the trailing comma, but it will break under IE.

- -

You may also need to delay instantiating any dygraphs until after the DOM -content is ready, as there have been some reports -that excanvas won't work until this happens. If you're using jQuery, this -means drawing your charts inside of a $(function() { ... }) -block.

+

If you need to support older versions of IE, which do not have native + <canvas> implementations, you'll need to use the 1.x series of dygraphs and follow its instructions for IE. +

-- 2.7.4