[Summary view] [Print] [Text view]

   1  /**
   2  * @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
   3  */
   4  ;(function(window, document) {
   5  /*jshint evil:true */
   6    /** version */
   7    var version = '3.7.3';
   8  
   9    /** Preset options */
  10    var options = window.html5 || {};
  11  
  12    /** Used to skip problem elements */
  13    var reSkip = /^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i;
  14  
  15    /** Not all elements can be cloned in IE **/
  16    var saveClones = /^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i;
  17  
  18    /** Detect whether the browser supports default html5 styles */
  19    var supportsHtml5Styles;
  20  
  21    /** Name of the expando, to work with multiple documents or to re-shiv one document */
  22    var expando = '_html5shiv';
  23  
  24    /** The id for the the documents expando */
  25    var expanID = 0;
  26  
  27    /** Cached data for each document */
  28    var expandoData = {};
  29  
  30    /** Detect whether the browser supports unknown elements */
  31    var supportsUnknownElements;
  32  
  33    (function() {
  34      try {
  35          var a = document.createElement('a');
  36          a.innerHTML = '<xyz></xyz>';
  37          //if the hidden property is implemented we can assume, that the browser supports basic HTML5 Styles
  38          supportsHtml5Styles = ('hidden' in a);
  39  
  40          supportsUnknownElements = a.childNodes.length == 1 || (function() {
  41            // assign a false positive if unable to shiv
  42            (document.createElement)('a');
  43            var frag = document.createDocumentFragment();
  44            return (
  45              typeof frag.cloneNode == 'undefined' ||
  46              typeof frag.createDocumentFragment == 'undefined' ||
  47              typeof frag.createElement == 'undefined'
  48            );
  49          }());
  50      } catch(e) {
  51        // assign a false positive if detection fails => unable to shiv
  52        supportsHtml5Styles = true;
  53        supportsUnknownElements = true;
  54      }
  55  
  56    }());
  57  
  58    /*--------------------------------------------------------------------------*/
  59  
  60    /**
  61     * Creates a style sheet with the given CSS text and adds it to the document.
  62     * @private
  63     * @param {Document} ownerDocument The document.
  64     * @param {String} cssText The CSS text.
  65     * @returns {StyleSheet} The style element.
  66     */
  67    function addStyleSheet(ownerDocument, cssText) {
  68      var p = ownerDocument.createElement('p'),
  69          parent = ownerDocument.getElementsByTagName('head')[0] || ownerDocument.documentElement;
  70  
  71      p.innerHTML = 'x<style>' + cssText + '</style>';
  72      return parent.insertBefore(p.lastChild, parent.firstChild);
  73    }
  74  
  75    /**
  76     * Returns the value of `html5.elements` as an array.
  77     * @private
  78     * @returns {Array} An array of shived element node names.
  79     */
  80    function getElements() {
  81      var elements = html5.elements;
  82      return typeof elements == 'string' ? elements.split(' ') : elements;
  83    }
  84  
  85    /**
  86     * Extends the built-in list of html5 elements
  87     * @memberOf html5
  88     * @param {String|Array} newElements whitespace separated list or array of new element names to shiv
  89     * @param {Document} ownerDocument The context document.
  90     */
  91    function addElements(newElements, ownerDocument) {
  92      var elements = html5.elements;
  93      if(typeof elements != 'string'){
  94        elements = elements.join(' ');
  95      }
  96      if(typeof newElements != 'string'){
  97        newElements = newElements.join(' ');
  98      }
  99      html5.elements = elements +' '+ newElements;
 100      shivDocument(ownerDocument);
 101    }
 102  
 103     /**
 104     * Returns the data associated to the given document
 105     * @private
 106     * @param {Document} ownerDocument The document.
 107     * @returns {Object} An object of data.
 108     */
 109    function getExpandoData(ownerDocument) {
 110      var data = expandoData[ownerDocument[expando]];
 111      if (!data) {
 112          data = {};
 113          expanID++;
 114          ownerDocument[expando] = expanID;
 115          expandoData[expanID] = data;
 116      }
 117      return data;
 118    }
 119  
 120    /**
 121     * returns a shived element for the given nodeName and document
 122     * @memberOf html5
 123     * @param {String} nodeName name of the element
 124     * @param {Document|DocumentFragment} ownerDocument The context document.
 125     * @returns {Object} The shived element.
 126     */
 127    function createElement(nodeName, ownerDocument, data){
 128      if (!ownerDocument) {
 129          ownerDocument = document;
 130      }
 131      if(supportsUnknownElements){
 132          return ownerDocument.createElement(nodeName);
 133      }
 134      if (!data) {
 135          data = getExpandoData(ownerDocument);
 136      }
 137      var node;
 138  
 139      if (data.cache[nodeName]) {
 140          node = data.cache[nodeName].cloneNode();
 141      } else if (saveClones.test(nodeName)) {
 142          node = (data.cache[nodeName] = data.createElem(nodeName)).cloneNode();
 143      } else {
 144          node = data.createElem(nodeName);
 145      }
 146  
 147      // Avoid adding some elements to fragments in IE < 9 because
 148      // * Attributes like `name` or `type` cannot be set/changed once an element
 149      //   is inserted into a document/fragment
 150      // * Link elements with `src` attributes that are inaccessible, as with
 151      //   a 403 response, will cause the tab/window to crash
 152      // * Script elements appended to fragments will execute when their `src`
 153      //   or `text` property is set
 154      return node.canHaveChildren && !reSkip.test(nodeName) && !node.tagUrn ? data.frag.appendChild(node) : node;
 155    }
 156  
 157    /**
 158     * returns a shived DocumentFragment for the given document
 159     * @memberOf html5
 160     * @param {Document} ownerDocument The context document.
 161     * @returns {Object} The shived DocumentFragment.
 162     */
 163    function createDocumentFragment(ownerDocument, data){
 164      if (!ownerDocument) {
 165          ownerDocument = document;
 166      }
 167      if(supportsUnknownElements){
 168          return ownerDocument.createDocumentFragment();
 169      }
 170      data = data || getExpandoData(ownerDocument);
 171      var clone = data.frag.cloneNode(),
 172          i = 0,
 173          elems = getElements(),
 174          l = elems.length;
 175      for(;i<l;i++){
 176          clone.createElement(elems[i]);
 177      }
 178      return clone;
 179    }
 180  
 181    /**
 182     * Shivs the `createElement` and `createDocumentFragment` methods of the document.
 183     * @private
 184     * @param {Document|DocumentFragment} ownerDocument The document.
 185     * @param {Object} data of the document.
 186     */
 187    function shivMethods(ownerDocument, data) {
 188      if (!data.cache) {
 189          data.cache = {};
 190          data.createElem = ownerDocument.createElement;
 191          data.createFrag = ownerDocument.createDocumentFragment;
 192          data.frag = data.createFrag();
 193      }
 194  
 195  
 196      ownerDocument.createElement = function(nodeName) {
 197        //abort shiv
 198        if (!html5.shivMethods) {
 199            return data.createElem(nodeName);
 200        }
 201        return createElement(nodeName, ownerDocument, data);
 202      };
 203  
 204      ownerDocument.createDocumentFragment = Function('h,f', 'return function(){' +
 205        'var n=f.cloneNode(),c=n.createElement;' +
 206        'h.shivMethods&&(' +
 207          // unroll the `createElement` calls
 208          getElements().join().replace(/[\w\-:]+/g, function(nodeName) {
 209            data.createElem(nodeName);
 210            data.frag.createElement(nodeName);
 211            return 'c("' + nodeName + '")';
 212          }) +
 213        ');return n}'
 214      )(html5, data.frag);
 215    }
 216  
 217    /*--------------------------------------------------------------------------*/
 218  
 219    /**
 220     * Shivs the given document.
 221     * @memberOf html5
 222     * @param {Document} ownerDocument The document to shiv.
 223     * @returns {Document} The shived document.
 224     */
 225    function shivDocument(ownerDocument) {
 226      if (!ownerDocument) {
 227          ownerDocument = document;
 228      }
 229      var data = getExpandoData(ownerDocument);
 230  
 231      if (html5.shivCSS && !supportsHtml5Styles && !data.hasCSS) {
 232        data.hasCSS = !!addStyleSheet(ownerDocument,
 233          // corrects block display not defined in IE6/7/8/9
 234          'article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}' +
 235          // adds styling not present in IE6/7/8/9
 236          'mark{background:#FF0;color:#000}' +
 237          // hides non-rendered elements
 238          'template{display:none}'
 239        );
 240      }
 241      if (!supportsUnknownElements) {
 242        shivMethods(ownerDocument, data);
 243      }
 244      return ownerDocument;
 245    }
 246  
 247    /*--------------------------------------------------------------------------*/
 248  
 249    /**
 250     * The `html5` object is exposed so that more elements can be shived and
 251     * existing shiving can be detected on iframes.
 252     * @type Object
 253     * @example
 254     *
 255     * // options can be changed before the script is included
 256     * html5 = { 'elements': 'mark section', 'shivCSS': false, 'shivMethods': false };
 257     */
 258    var html5 = {
 259  
 260      /**
 261       * An array or space separated string of node names of the elements to shiv.
 262       * @memberOf html5
 263       * @type Array|String
 264       */
 265      'elements': options.elements || 'abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video',
 266  
 267      /**
 268       * current version of html5shiv
 269       */
 270      'version': version,
 271  
 272      /**
 273       * A flag to indicate that the HTML5 style sheet should be inserted.
 274       * @memberOf html5
 275       * @type Boolean
 276       */
 277      'shivCSS': (options.shivCSS !== false),
 278  
 279      /**
 280       * Is equal to true if a browser supports creating unknown/HTML5 elements
 281       * @memberOf html5
 282       * @type boolean
 283       */
 284      'supportsUnknownElements': supportsUnknownElements,
 285  
 286      /**
 287       * A flag to indicate that the document's `createElement` and `createDocumentFragment`
 288       * methods should be overwritten.
 289       * @memberOf html5
 290       * @type Boolean
 291       */
 292      'shivMethods': (options.shivMethods !== false),
 293  
 294      /**
 295       * A string to describe the type of `html5` object ("default" or "default print").
 296       * @memberOf html5
 297       * @type String
 298       */
 299      'type': 'default',
 300  
 301      // shivs the document according to the specified `html5` object options
 302      'shivDocument': shivDocument,
 303  
 304      //creates a shived element
 305      createElement: createElement,
 306  
 307      //creates a shived documentFragment
 308      createDocumentFragment: createDocumentFragment,
 309  
 310      //extends list of elements
 311      addElements: addElements
 312    };
 313  
 314    /*--------------------------------------------------------------------------*/
 315  
 316    // expose html5
 317    window.html5 = html5;
 318  
 319    // shiv the document
 320    shivDocument(document);
 321  
 322    if(typeof module == 'object' && module.exports){
 323      module.exports = html5;
 324    }
 325  
 326  }(typeof window !== "undefined" ? window : this, document));