Minimal HTML5 element shiv for IE8
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Initial and hopefully final release Jul 20, 2014
npm-shivie8
LICENSE
README.md
package.json

README.md

shivIE8 1.0.0

Minimal HTML5 element shiv for IE8. Forked from html5shiv. Only 347 bytes uncompressed, 265 bytes compressed!

This is a vastly simplified fork of html5shiv that focuses only on supporting HTML5 elements for IE8 (supported natively by IE9). IE8 is still prevalent enough that many can't afford to ignore it and many frameworks explicitly advertise support for IE8. Many frameworks (like React) do not include the HTML5 elements shiv for IE8.

IE Quirks and IE6+ are also supported by this shiv. FireFox 3+ and Safari 4+ have no inherent issues with HTML5 elements when used with the shiv stylesheet below.

IE8 is the last of a plagued breed, due to the extremely limited scope and simplicity of this workaround, expect this to be the last and final release... unless an issue is discovered.

Use this stylesheet

This script does NOT attach a stylesheet with default styles for HTML5 elements. Instead, copy the CSS below and put it at the top of your base/reset stylesheet, customize as you please.

article, aside, dialog, figcaption, figure, footer, header, hgroup, main, nav, section {
  display: block;
}
mark {
  background: #FFFF00; color: #000000;
}
template {
  display: none;
}

Use as script

Shivs document on load, call shivIEDocumentElements(otherDocument) if necessary.

<script src="shivie8.min.js"></script>

Use as module

Shivs document on require, call shivie8(otherDocument) if necessary.

// dist/amd/shivie8.js
define(['shivie8'], function(shivie8) {
  // optional
  shivie8(otherDocument);
});
// dist/commonjs/shivie8.js
// npm install shivie8
// bower install shivie8
require('shivie8');
// or
var shivie8 = require('shivie8');
shivie8(otherDocument);

Template danger

<template> is not reliable as its content is always evaluated by IE8. Reading from its innerHTML is also unsafe in IE8 due to insufficient escaping, white-space is also not correctly preserved. User supplied data in template is likely susceptible to XSS, use <script type="text/plain"> instead.