HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/7056

File a bug

SVNBugCommentTime (UTC)
7056Apply some WG chair decisions.2012-04-18 06:57
Index: source
===================================================================
--- source	(revision 7055)
+++ source	(revision 7056)
@@ -234,6 +234,17 @@
    href="http://lists.w3.org/Archives/Public/public-html/2012Jan/0131.html">working
    group chair decision from November 2011</a>.</li>
 
+   <li>The W3C HTML specification omits a number of suggestions
+   regarding using the <code title="attr-title">title</code>
+   attribute, and makes using the <code
+   title="attr-title">title</code> attribute for captions
+   non-conforming in certain specific cases, because of a number of
+   working group chair decisions from March 2012:
+   <a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0555.html">first</a>,
+   <a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0731.html">second</a>,
+   <a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0785.html">third</a>.
+   </li><!--FORK--><!--TITLE-->
+
   </ul>
 
   <p>The following sections are only published in the WHATWG
@@ -11598,8 +11609,9 @@
   title or a description of the target resource; on an image, it could
   be the image credit or a description of the image; on a paragraph,
   it could be a footnote or commentary on the text; on a citation, it
-  could be further information about the source; and so forth. The
-  value is text.</p>
+  could be further information about the source; on <span>interactive
+  content</span>, it could be a label for, or instructions for, use of
+  the element; and so forth. The value is text.</p>
 
   <p>If this attribute is omitted from an element, then it implies
   that the <code title="attr-title">title</code> attribute of the
@@ -21892,9 +21904,37 @@
   <div class="example">
 
    <p>In this example, which could be part of a much larger work
-   discussing a castle, the figure has three images in it.</p>
+   discussing a castle, nested <code>figure</code> elements are used
+   to provide both a group caption and individual captions for each
+   figure in the group:</p>
 
    <pre>&lt;figure>
+ &lt;figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption>
+ &lt;figure>
+  &lt;figcaption>Etching. Anonymous, ca. 1423.&lt;/figcaption>
+  &lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it.">
+ &lt;/figure>
+ &lt;figure>
+  &lt;figcaption>Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption>
+  &lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls.">
+ &lt;/figure>
+ &lt;figure>
+  &lt;figcaption>Film photograph. Peter Jankle, 1999.&lt;/figcaption>
+  &lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece.">
+ &lt;/figure>
+&lt;/figure></pre>
+
+  </div>
+
+<!--END w3c-html--><!--FORK--><!--TITLE-->
+  <div class="example">
+
+   <p>The previous example could also be more succintly written as
+   follows (using <code title="attr-title">title</code> attributes in
+   place of the nested <code>figure</code>/<code>figcaption</code>
+   pairs):</p>
+
+   <pre>&lt;figure>
  &lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
       alt="The castle has one tower, and a tall wall around it.">
  &lt;img src="castle1858.jpeg" title="Oil-based paint on canvas. Maria Towle, 1858."
@@ -21905,6 +21945,7 @@
 &lt;/figure></pre>
 
   </div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
 
 
   <h4>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -25546,6 +25587,7 @@
      <!-- when editing this list, search for the two other occurrences
      of 'critical-no-alt' -->
 
+<!--TITLE--><!-- this is not omitted for some reason; see http://www.w3.org/html/wg/wiki/ChangeProposals/notitlev2#Details -->
      <li><p>If the image has a <code title="attr-title">title</code>
      attribute whose value is not the empty string, then the value of
      that attribute is the caption information; abort these
@@ -26573,8 +26615,10 @@
      <!-- when editing this list, search for the two other occurrences
      of 'critical-no-alt' -->
 
+<!--END w3c-html--><!--FORK--><!--TITLE-->
      <li>The <code title="attr-title">title</code> attribute is
      present and has a non-empty value.</li>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
 
      <li id="figcaption-as-alt-condition">The <code>img</code> element
      is in a <code>figure</code> element that contains a
@@ -26788,9 +26832,11 @@
    <!-- when editing this list, search for the two other occurrences
    of 'critical-no-alt' -->
 
+<!--END w3c-html--><!--FORK--><!--TITLE-->
    <li>The <code title="attr-title">title</code> attribute is present
    and has a non-empty value (as <a href="#unknown-images">described
    above</a>).</li>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
 
    <li>The <code>img</code> element is in a <code>figure</code>
    element that satisfies <a href="#figcaption-as-alt-condition">the
@@ -68578,6 +68624,7 @@
   <p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.</p>
 
+<!--END w3c-html--><!--FORK--><!--TITLE-->
   <hr>
 
   <p>For short inline annotations, the <code
@@ -68597,12 +68644,17 @@
 closing for lunch&lt;/span>.</pre>
 
   </div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
 
   <hr>
 
-  <p>For longer annotations, the <code>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>
+  <p>For
+<!--END w3c-html--><!--FORK--><!--TITLE-->
+  longer
+<!--START w3c-html--><!--FORK--><!--TITLE-->
+  annotations, the <code>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>
 
   <div class="example">
 

|