[html5] r7249 - [giow] (0) More tweaking of title='' conf critera. Affected topics: HTML, Rendering

whatwg at whatwg.org whatwg at whatwg.org
Tue Aug 21 16:35:15 PDT 2012


Author: ianh
Date: 2012-08-21 16:35:13 -0700 (Tue, 21 Aug 2012)
New Revision: 7249

Modified:
   complete.html
   index
   source
Log:
[giow] (0) More tweaking of title='' conf critera.
Affected topics: HTML, Rendering

Modified: complete.html
===================================================================
--- complete.html	2012-08-21 23:20:36 UTC (rev 7248)
+++ complete.html	2012-08-21 23:35:13 UTC (rev 7249)
@@ -11346,11 +11346,11 @@
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the
@@ -11387,7 +11387,8 @@
 
   <p>The <dfn id=advisory-information>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol><li><p>If the element is a <code><a href=#the-link-element>link</a></code>, <code><a href=#the-style-element>style</a></code>,
    <code><a href=#the-dfn-element>dfn</a></code>, <code><a href=#the-abbr-element>abbr</a></code>, or <code><a href=#the-title-element>title</a></code> element,
@@ -11403,7 +11404,11 @@
 
    <li><p>Otherwise, return the empty string.</li>
 
-  </ol><hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
+  </ol><p>User agents should inform the user when elements have
+  <a href=#advisory-information>advisory information</a>, otherwise the information would
+  not be discoverable.</p>
+
+  <hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
   must <a href=#reflect>reflect</a> the <code title=attr-title><a href=#attr-title>title</a></code>
   content attribute.</p>
 
@@ -25836,12 +25841,12 @@
       present and has a non-empty value.</p>
 
       <!-- search for title-warning if modifying this paragraph -->
-      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -62076,7 +62081,8 @@
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 
-  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute should be used.</p>
+  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class=example>
 
@@ -62092,6 +62098,28 @@
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class=note>Unfortunately, relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class=note>If the <code title=attr-title><a href=#attr-title>title</a></code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class=example>
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title=attr-title><a href=#attr-title>title</a></code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
   used, pointing to an element later in the document. The convention
   is that the contents of the link be a number in square brackets.</p>
@@ -99105,7 +99133,8 @@
   <h4 id=the-title-attribute-0><span class=secno>14.7.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h4>
 
   <p>User agents are expected to expose the <a href=#advisory-information>advisory
-  information</a> of elements upon user request.</p>
+  information</a> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the

Modified: index
===================================================================
--- index	2012-08-21 23:20:36 UTC (rev 7248)
+++ index	2012-08-21 23:35:13 UTC (rev 7249)
@@ -11346,11 +11346,11 @@
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the
@@ -11387,7 +11387,8 @@
 
   <p>The <dfn id=advisory-information>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol><li><p>If the element is a <code><a href=#the-link-element>link</a></code>, <code><a href=#the-style-element>style</a></code>,
    <code><a href=#the-dfn-element>dfn</a></code>, <code><a href=#the-abbr-element>abbr</a></code>, or <code><a href=#the-title-element>title</a></code> element,
@@ -11403,7 +11404,11 @@
 
    <li><p>Otherwise, return the empty string.</li>
 
-  </ol><hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
+  </ol><p>User agents should inform the user when elements have
+  <a href=#advisory-information>advisory information</a>, otherwise the information would
+  not be discoverable.</p>
+
+  <hr><p>The <dfn id=dom-title title=dom-title><code>title</code></dfn> IDL attribute
   must <a href=#reflect>reflect</a> the <code title=attr-title><a href=#attr-title>title</a></code>
   content attribute.</p>
 
@@ -25836,12 +25841,12 @@
       present and has a non-empty value.</p>
 
       <!-- search for title-warning if modifying this paragraph -->
-      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      <p class=note>Relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -62076,7 +62081,8 @@
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 
-  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute should be used.</p>
+  <hr><p>For short inline annotations, the <code title=attr-title><a href=#attr-title>title</a></code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class=example>
 
@@ -62092,6 +62098,28 @@
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class=note>Unfortunately, relying on the <code title=attr-title><a href=#attr-title>title</a></code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class=note>If the <code title=attr-title><a href=#attr-title>title</a></code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class=example>
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title=attr-title><a href=#attr-title>title</a></code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
   used, pointing to an element later in the document. The convention
   is that the contents of the link be a number in square brackets.</p>
@@ -99105,7 +99133,8 @@
   <h4 id=the-title-attribute-0><span class=secno>14.7.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h4>
 
   <p>User agents are expected to expose the <a href=#advisory-information>advisory
-  information</a> of elements upon user request.</p>
+  information</a> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the

Modified: source
===================================================================
--- source	2012-08-21 23:20:36 UTC (rev 7248)
+++ source	2012-08-21 23:35:13 UTC (rev 7249)
@@ -11746,11 +11746,11 @@
 
   <!-- search for title-warning if modifying this paragraph -->
   <p class="note">Relying on the <code title="attr-title">title</code>
-  attribute is discouraged as many user agents do not expose the
-  attribute in an accessible manner as required by this specification
-  (e.g. requiring a pointing device such as a mouse to cause a tooltip
-  to apear, which excludes keyboard-only users and touch-only users,
-  such as anyone with a modern phone or tablet).</p>
+  attribute is currently discouraged as many user agents do not expose
+  the attribute in an accessible manner as required by this
+  specification (e.g. requiring a pointing device such as a mouse to
+  cause a tooltip to apear, which excludes keyboard-only users and
+  touch-only users, such as anyone with a modern phone or tablet).</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title="attr-title">title</code> attribute of the
@@ -11789,7 +11789,8 @@
 
   <p>The <dfn>advisory information</dfn> of an element is the value
   that the following algorithm returns, with the algorithm being
-  aborted once a value is returned:</p>
+  aborted once a value is returned. When the algorithm returns the
+  empty string, then there is no advisory information.</p>
 
   <ol>
 
@@ -11810,6 +11811,10 @@
 
   </ol>
 
+  <p>User agents should inform the user when elements have
+  <span>advisory information</span>, otherwise the information would
+  not be discoverable.</p>
+
   <hr>
 
   <p>The <dfn title="dom-title"><code>title</code></dfn> IDL attribute
@@ -27821,12 +27826,12 @@
 
       <!-- search for title-warning if modifying this paragraph -->
       <p class="note">Relying on the <code
-      title="attr-title">title</code> attribute is discouraged as many
-      user agents do not expose the attribute in an accessible manner
-      as required by this specification (e.g. requiring a pointing
-      device such as a mouse to cause a tooltip to apear, which
-      excludes keyboard-only users and touch-only users, such as
-      anyone with a modern phone or tablet).</p>
+      title="attr-title">title</code> attribute is currently
+      discouraged as many user agents do not expose the attribute in
+      an accessible manner as required by this specification (e.g.
+      requiring a pointing device such as a mouse to cause a tooltip
+      to apear, which excludes keyboard-only users and touch-only
+      users, such as anyone with a modern phone or tablet).</p>
 
      </li>
 
@@ -72523,7 +72528,8 @@
   <hr>
 
   <p>For short inline annotations, the <code
-  title="attr-title">title</code> attribute should be used.</p>
+  title="attr-title">title</code> attribute could <!-- SHOULD, modulo
+  title-warning --> be used.</p>
 
   <div class="example">
 
@@ -72540,6 +72546,29 @@
 
   </div>
 
+  <!-- search for title-warning if modifying this paragraph -->
+  <p class="note">Unfortunately, relying on the <code
+  title="attr-title">title</code> attribute is currently discouraged
+  as many user agents do not expose the attribute in an accessible
+  manner as required by this specification (e.g. requiring a pointing
+  device such as a mouse to cause a tooltip to apear, which excludes
+  keyboard-only users and touch-only users, such as anyone with a
+  modern phone or tablet).</p>
+
+  <p class="note">If the <code title="attr-title">title</code>
+  attribute is used, CSS can used to draw the reader's attention to
+  the elements with the attribute.</p>
+
+  <div class="example">
+
+   <p>For example, the following CSS places a dashed line below
+   elements that have a <code title="attr-title">title</code>
+   attribute.</p>
+
+   <pre>[title] { border-bottom: thin dashed; }</pre>
+
+  </div>
+
   <hr>
 
   <p>For longer annotations, the <code>a</code> element should be
@@ -115784,7 +115813,8 @@
   <h4>The <code title="attr-title">title</code> attribute</h4>
 
   <p>User agents are expected to expose the <span>advisory
-  information</span> of elements upon user request.</p>
+  information</span> of elements upon user request, and to make the
+  user aware of the presence of such information.</p>
 
   <p>On interactive graphical systems where the user can use a
   pointing device, this could take the form of a tooltip. When the




More information about the Commit-Watchers mailing list