Strict Standard

Author: ptrdo

README.md

@@ -1,5 +1,5 @@
 ###### This is released software. Please **[log issues](https://github.com/ptrdo/microdata-template/issues)** found. 
-# microdata-template `v2.2.1`
+# microdata-template `v2.2.2`
 An implementation of HTML template by way of the microdata mechanism.
 ### The Gist  
 This JavaScript module should simplify adding dynamic content to HTML documents while staying true to the recommendations of web standards. There are no dependencies here except the JavaScript [ECMA5 standard](http://www.ecma-international.org/ecma-262/5.1/) which enjoys [nearly universal support](http://kangax.github.io/compat-table/es5/) in modern browsers. Also, since the HTML recommendations for integral technologies such as [template](https://www.w3.org/TR/html52/semantics-scripting.html#the-template-element) and [microdata](https://www.w3.org/TR/microdata/) are variably implemented by modern browsers, this module serves as a [polyfill](https://en.wikipedia.org/wiki/Polyfill) to assure reliable results. Best of all, this methodology encourages the writing of low-dependency JavaScript and perfectly valid HTML — even within fully-functional templated markup.
@@ -149,7 +149,7 @@ import templater from "./path/to/microdata-template.js";
 let itemToReplicate = document.querySelector("[itemprop][hidden]"); // the template
 let parentOfClones = document.getElementById("months"); // the parent of the template
 
-templater.render(itemToReplicate||parentOfClones, myData); // either works!
+templater.render(itemToReplicate||parentOfClones, myData); // either works when strictStandards = true;
 ```
 
 >**NOTE:** The [microdata specification](https://www.w3.org/TR/microdata/) requires an element with an `itemscope` attribute to also have either an `itemref` or `itemtype` attribute, but this rule is not enforced here. 
@@ -260,20 +260,27 @@ Once instantiated in the web client code, the microdata-template can be addresse
 ```javascript
 // In pre-ES6 implementations, the code is exposed to the global namespace: 
 var templater = window.MicrodataTemplate.init();
-templater.getVerson(); // returns current version, e.g. "2.2.1"
+templater.getVerson(); // returns current version, e.g. "2.2.2"
 
 // In ES6 implementations, the import code does not require init() 
 import templater from "./path/to/microdata-template.js";
-templater.getVersion(); // returns current version, e.g. "2.2.1" 
+templater.getVersion(); // returns current version, e.g. "2.2.2"
 
+// Defaults are assumed, but configuration can be passed to init: 
+templater.init({
+  showHeritage: true, // bypass obj.hasOwnProperty() filtering.
+  strictStandard: true // require Microdata attributes.
+});
 ```
 
 | Method Name | Argument(s) | Description |
 |-------------|-------------|-------------|
-| `init` | *none* | Returns an instance of the microdata-template. |
+| `init` | *Object (optional)* | Returns an instance of the microdata-template. Config object is optional. |
 | `render` | *element, data* | Populates the HTML element template with data. |
 | `clear` | *element, callback* | Removes dynamically populated content, retaining the original template. |
 | `refresh` | *element, data* | Makes current a previously rendered template. |
+| `getSetShowHeritage` | *Boolean* | False by default. When true, bypasses obj.hasOwnProperty() filtering. |
+| `getSetStrictStandard` | *Boolean* | False by default. When true, Microdata attributes are always required. |
 | `setTransformer` | *name, func* | Provides for a custom transformer. | 
 | `getTransformers` | *none* | Returns default and custom transformers. |
 | `getVersion` | *none* | Returns the current version. | 

lib/microdata-template.js

@@ -8,7 +8,7 @@
    * @author Peter Sylwester
    * @copyright (c)2019 Peter Sylwester
    * @license MIT
-   * @version 2.2.0, 2019/09/13
+   * @version 2.2.2, 2019/09/16
    * @requires "HTML5", "ECMA-262 Edition 5.1"
    *
    *
@@ -53,7 +53,7 @@
 }(this, (function () {
   "use strict";
 
-  var element, source, version = "2.2.1";
+  var element, source, version = "2.2.2";
 
   /**
    * Markers are the HTML node element attributes used to designate components of the templated markup.
@@ -181,6 +181,14 @@
    */
   var showHeritage = false;
 
+  /**
+   * strictStandard determines Microdata compliance. 
+   * 
+   * @public via proxy
+   * @type {Boolean} When true, requires Microdata attributes for template.
+   */
+  var strictStandard = false; 
+
 
   /* PRIVATE UTILITIES */
 
@@ -202,16 +210,18 @@
   };
 
   var isTemplate = function (node) {
-    return !!node && !!node.hasAttribute
-        && node.hasAttribute(MARKER.hidden)
-        && (node.hasAttribute(MARKER.repeat) || node.hasAttribute(MARKER.property) || node.hasAttribute(MARKER.binder));
+    return !!node && !!node.hasAttribute 
+      && node.hasAttribute(MARKER.hidden)
+      && (node.hasAttribute(MARKER.repeat) 
+      || node.hasAttribute(MARKER.property) 
+      || node.hasAttribute(MARKER.binder));
   };
 
   var isNestedTemplate = function (node) {
     return !!node && !!node.hasAttribute
-        && node.hasAttribute(MARKER.hidden)
-        && node.hasAttribute(MARKER.repeat)
-        && node.hasAttribute(MARKER.source);
+      && node.hasAttribute(MARKER.hidden)
+      && node.hasAttribute(MARKER.repeat)
+      && node.hasAttribute(MARKER.source);
   };
 
   var denude = function (clone) {
@@ -223,7 +233,9 @@
 
   var findTemplate = function (node) {
     var candidate;
-    if (isTemplate(node)) {
+    if (!strictStandard) {
+      return node;
+    } else if (isTemplate(node)) {
       return node;
     } else if (!!node && !!node.querySelector) {
       candidate = node.querySelector("["+MARKER.hidden+"]");
@@ -346,7 +358,7 @@
           }
           if (!!proxy) {
             if (alternates.length > 1) {
-              proxy = alternates.filter(function (alt, j, arr) {
+              proxy = alternates.filter(function (alt, k, arr) {
                 if (PATTERN.address.test(alt)) {
                   return alt;
                 } else if (alt in datum) {
@@ -360,7 +372,7 @@
                 }
               })[0];
             }
-            if (!!combo) {
+            if (!!combo && Array.isArray(proxy)) {
               // this is a parenthetical, e/g combineString:(foo,bar) 
               value = [];
               proxy.forEach(function (clause) {
@@ -442,7 +454,7 @@
                     }
                   })[0];
                 }
-                if (!!combo) {
+                if (!!combo && Array.isArray(proxy)) {
                   // this is a parenthetical, e/g combineString:(foo,bar)
                   value = [];
                   proxy.forEach(function (clause) {
@@ -625,7 +637,15 @@
 
     /* PUBLIC API */
 
-    init: function() {
+    init: function(config) {
+      if (arguments.length > 0 && Object(config) === config) {
+        if ("strictStandard" in config) {
+          strictStandard = !!config.strictStandard;
+        }
+        if ("showHeritage" in config) {
+          strictStandard = !!config.showHeritage;
+        }
+      }
       return this;
     },
 
@@ -710,19 +730,30 @@
         return null;
       }
     },
-
-    /**
-     * @param boo {Boolean} When true the obj.hasOwnProperty() is not enforced.
-     * @returns {Boolean} The current setting.
-     */
+    
     getSetShowHeritage: function (boo) {
-
+      /**
+       * @param boo {Boolean} When true the obj.hasOwnProperty() is not enforced.
+       * @returns {Boolean} The current setting.
+       */
       if (arguments.length > 0) {
         showHeritage = !!boo;
       }
 
       return showHeritage;
     },
+    
+    getSetStrictStandard: function (boo) {
+      /**
+       * @param boo {Boolean} When true Microdata attributes are always required.
+       * @returns {Boolean} The current setting.
+       */
+      if (arguments.length > 0) {
+        strictStandard = !!boo;
+      }
+
+      return showHeritage;
+    },
 
     getSetSource: function (obj) {
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "microdata-template",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "An implementation of HTML template by way of the microdata mechanism.",
   "keywords": [
     "javascript",