[html5] r8671 - [e] (0) Update data-*='' definition to make what we do with anolis more valid... [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2014-06-11 11:18:06 -0700 (Wed, 11 Jun 2014)
New Revision: 8671

Modified:
   complete.html
   index
   source
Log:
[e] (0) Update data-*='' definition to make what we do with anolis more valid...
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2014-06-11 04:04:23 UTC (rev 8670)
+++ complete.html	2014-06-11 18:18:06 UTC (rev 8671)
@@ -11156,8 +11156,10 @@
   data private to the page or application, for which there are no more appropriate attributes or
   elements.</p>
 
-  <p>These attributes are not intended for use by software that is independent of the site that uses
-  the attributes.</p>
+  <p>These attributes are not intended for use by software that is not known to the administrators
+  of the site that uses the attributes. For generic extensions that are to be used by multiple
+  independent tools, either this specification should be extended to provide the feature explicitly,
+  or a technology like <a href=#microdata>microdata</a> should be used (with a standardised vocabulary).</p>
 
   <div class=example>
 
@@ -11179,6 +11181,20 @@
 
   </div>
 
+  <div class=example>
+
+   <p>Similarly, a page author could write markup that provides information for a translation tool
+   that they are intending to use:</p>
+
+   <pre><p>The third <span data-mytrans-de="Anspruch">claim</span> covers the case of <span
+data-mytrans-all="HTML">HTML</span> markup.</p></pre>
+
+   <p>(In this example, the "<code title="">data-mytrans-de</code>" attribute gives specific text
+   for the MyTrans product to use when translating the phrase "claim" to German, and the "<code title="">data-mytrans-all</code>" attribute gives tells it that in all languages, "HTML" is to
+   remain unchanged.)</p>
+
+  </div>
+
   <p>Every <a href=#html-elements title="HTML elements">HTML element</a> may have any number of <a href=#custom-data-attribute title="custom data attribute">custom data attributes</a> specified, with any value.</p>
 
   <hr><dl class=domintro><dt><var title="">element</var> . <code title=dom-dataset><a href=#dom-dataset>dataset</a></code></dt>

Modified: index
===================================================================
--- index	2014-06-11 04:04:23 UTC (rev 8670)
+++ index	2014-06-11 18:18:06 UTC (rev 8671)
@@ -11156,8 +11156,10 @@
   data private to the page or application, for which there are no more appropriate attributes or
   elements.</p>
 
-  <p>These attributes are not intended for use by software that is independent of the site that uses
-  the attributes.</p>
+  <p>These attributes are not intended for use by software that is not known to the administrators
+  of the site that uses the attributes. For generic extensions that are to be used by multiple
+  independent tools, either this specification should be extended to provide the feature explicitly,
+  or a technology like <a href=#microdata>microdata</a> should be used (with a standardised vocabulary).</p>
 
   <div class=example>
 
@@ -11179,6 +11181,20 @@
 
   </div>
 
+  <div class=example>
+
+   <p>Similarly, a page author could write markup that provides information for a translation tool
+   that they are intending to use:</p>
+
+   <pre><p>The third <span data-mytrans-de="Anspruch">claim</span> covers the case of <span
+data-mytrans-all="HTML">HTML</span> markup.</p></pre>
+
+   <p>(In this example, the "<code title="">data-mytrans-de</code>" attribute gives specific text
+   for the MyTrans product to use when translating the phrase "claim" to German, and the "<code title="">data-mytrans-all</code>" attribute gives tells it that in all languages, "HTML" is to
+   remain unchanged.)</p>
+
+  </div>
+
   <p>Every <a href=#html-elements title="HTML elements">HTML element</a> may have any number of <a href=#custom-data-attribute title="custom data attribute">custom data attributes</a> specified, with any value.</p>
 
   <hr><dl class=domintro><dt><var title="">element</var> . <code title=dom-dataset><a href=#dom-dataset>dataset</a></code></dt>

Modified: source
===================================================================
--- source	2014-06-11 04:04:23 UTC (rev 8670)
+++ source	2014-06-11 18:18:06 UTC (rev 8671)
@@ -11141,8 +11141,10 @@
   data private to the page or application, for which there are no more appropriate attributes or
   elements.</p>
 
-  <p>These attributes are not intended for use by software that is independent of the site that uses
-  the attributes.</p>
+  <p>These attributes are not intended for use by software that is not known to the administrators
+  of the site that uses the attributes. For generic extensions that are to be used by multiple
+  independent tools, either this specification should be extended to provide the feature explicitly,
+  or a technology like <span>microdata</span> should be used (with a standardised vocabulary).</p>
 
   <div class="example">
 
@@ -11164,6 +11166,21 @@
 
   </div>
 
+  <div class="example">
+
+   <p>Similarly, a page author could write markup that provides information for a translation tool
+   that they are intending to use:</p>
+
+   <pre><p>The third <span data-mytrans-de="Anspruch">claim</span> covers the case of <span
+data-mytrans-all="HTML">HTML</span> markup.</p></pre>
+
+   <p>(In this example, the "<code data-x="">data-mytrans-de</code>" attribute gives specific text
+   for the MyTrans product to use when translating the phrase "claim" to German, and the "<code
+   data-x="">data-mytrans-all</code>" attribute gives tells it that in all languages, "HTML" is to
+   remain unchanged.)</p>
+
+  </div>
+
   <p>Every <span data-x="HTML elements">HTML element</span> may have any number of <span
   data-x="custom data attribute">custom data attributes</span> specified, with any value.</p>