HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
7056Apply some WG chair decisions.2012-04-18 06:57
@@ -227,20 +227,31 @@
    2012</a>.</li><!--HIDDENARIA--><!--FORK-->
 
    <li>The W3C HTML specification does not define the term <span
    title="rel-sidebar-hyperlink">sidebar hyperlink</span>, forcing the
    definition of the <code title="rel-sidebar">sidebar</code> link
    type in the microformats wiki to rely on this copy of the spec
    instead, because of a <a
    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
   specifications and are not currently available anywhere else:</p>
 
   <ul>
    <li>New hyperlink features: the <code title="attr-hyperlink-download">download</code> attribute to make download links and the <code title="attr-hyperlink-ping">ping</code> attribute for <span>hyperlink auditing</span>.</li> <!--DOWNLOAD--><!--PING-->
    <li>The <code title="attr-inert">inert</code> global attribute to disable subtrees.</li><!--INERT-->
    <li>The <code title="attr-fs-method-dialog-keyword">dialog</code> keyword on the <code>form</code> element's <code title="attr-fs-method">method</code> attribute, for a simpler way to close dialogs.</li><!--FORM-DIALOG-->
    <li>The <code title="dom-document-cssElementMap">cssElementMap</code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
@@ -11591,22 +11602,23 @@ interface <dfn>HTMLUnknownElement</dfn> : <span>HTMLElement</span> { };</pre>
 
 
   <h5>The <dfn title="attr-title"><code>title</code></dfn> attribute</h5>
 
   <p>The <code title="attr-title">title</code> attribute
   <span>represents</span> advisory information for the element, such
   as would be appropriate for a tooltip. On a link, this could be the
   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
   nearest ancestor <span title="HTML elements">HTML element</span>
   with a <code title="attr-title">title</code> attribute set is also
   relevant to this element. Setting the attribute overrides this,
   explicitly stating that the advisory information of any ancestors is
   not relevant to this element. Setting the attribute to the empty
   string indicates that the element has no advisory information.</p>
 
@@ -21885,33 +21897,62 @@ included with Exhibit B.
  All mimsy were the borogoves,&lt;br>
  And the mome raths outgrabe.&lt;/p>
  &lt;figcaption>&lt;cite>Jabberwocky&lt;/cite> (first verse). Lewis Carroll, 1832-98&lt;/figcaption>
 &lt;/figure></pre>
 
   </div>
 
   <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."
       alt="The castle now has two towers and two walls.">
  &lt;img src="castle1999.jpeg" title="Film photograph. Peter Jankle, 1999."
       alt="The castle lies in ruins, the original tower all that remains in one piece.">
  &lt;figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption>
 &lt;/figure></pre>
 
   </div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
 
 
   <h4>The <dfn><code>figcaption</code></dfn> element</h4>
 
   <dl class="element">
    <dt><span title="element-dfn-categories">Categories</span>:</dt>
    <dd>None.</dd>
    <dt><span title="element-dfn-contexts">Contexts in which this element can be used</span>:</dt>
    <dd>As the first or last child of a <code>figure</code> element.</dd>
    <dt><span title="element-dfn-content-model">Content model</span>:</dt>
@@ -25539,20 +25580,21 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
     that there is an image that is not being rendered, and may, if
     requested by the user, or if so configured, or when required to
     provide contextual information in response to navigation, provide
     caption information for the image, derived as follows:</p>
 
     <ol>
 
      <!-- 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
      steps.</p></li>
 
      <li><p>If the image is a descendant of a <code>figure</code>
      element that has a child <code>figcaption</code> element, and,
      ignoring the <code>figcaption</code> element and its descendants,
      the <code>figure</code> element has no <code>Text</code> node
      descendants other than <span>inter-element whitespace</span>, and
@@ -26566,22 +26608,24 @@ of various sizes."></strong></pre>
 
     <p>In such cases, the <code title="attr-img-alt">alt</code>
     attribute may be omitted, but one of the following conditions must
     be met as well:</p>
 
     <ul>
 
      <!-- 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
      <code>figcaption</code> element that contains content other than
      <span>inter-element whitespace</span>, and, ignoring the
      <code>figcaption</code> element and its descendants, the
      <code>figure</code> element has no <code>Text</code> node
      descendants other than <span>inter-element whitespace</span>, and
      no <span>embedded content</span> descendant other than the
      <code>img</code> element.</li>
@@ -26781,23 +26825,25 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
 
   <p>A conformance checker must report the lack of an <code
   title="attr-img-alt">alt</code> attribute as an error unless one of
   the conditions listed below applies:</p>
 
   <ul>
 
    <!-- 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
    conditions described above</a>.</li>
 
    <!-- the following are additional entries not included in the
    aforementioned list, as they apply only to conformance checkers -->
 
 <!--END w3c-html--><!--FORK-->
    <li>The conformance checker has been configured to assume that the
@@ -68571,45 +68617,51 @@ fur
 &lt;/ul></pre>
 
   </div>
 
 
   <h4 id="footnotes">Footnotes</h4>
 
   <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
   title="attr-title">title</code> attribute should be used.</p>
 
   <div class="example">
 
    <p>In this example, two parts of a dialogue are annotated with
    footnote-like content using the <code
    title="attr-title">title</code> attribute.</p>
 
    <pre>&lt;p> &lt;b>Customer&lt;/b>: Hello! I wish to register a complaint. Hello. Miss?
 &lt;p> &lt;b>Shopkeeper&lt;/b>: <strong>&lt;span title="Colloquial pronunciation of 'What do you'"</strong>
 >Watcha&lt;/span> mean, miss?
 &lt;p> &lt;b>Customer&lt;/b>: Uh, I'm sorry, I have a cold. I wish to make a complaint.
 &lt;p> &lt;b>Shopkeeper&lt;/b>: Sorry, &lt;span <strong>title="This is, of course, a lie."</strong>>we're
 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">
 
    <p>In this example, a footnote in the dialogue links to a paragraph
    below the dialogue. The paragraph then reciprocally links back to the
    dialogue, allowing the user to return to the location of the
    footnote.</p>
 
    <pre>&lt;p> Announcer: Number 16: The &lt;i>hand&lt;/i>.
 &lt;p> Interviewer: Good evening. I have with me in the studio tonight

|