Skip to content
Permalink
Browse files

[e] (0) Apply some WG chair decisions.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7056 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Apr 18, 2012
1 parent 2b1d471 commit 4c98a1d49d557b464c1056d688e46d4c09163167
Showing with 174 additions and 26 deletions.
  1. +58 −10 complete.html
  2. +58 −10 index
  3. +58 −6 source

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 17 April 2012</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 18 April 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
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><a href=#the-title-attribute>title</a></code>
attribute, and makes using the <code title=attr-title><a href=#the-title-attribute>title</a></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>

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 <a href=#interactive-content>interactive
content</a>, 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><a href=#the-title-attribute>title</a></code> attribute of the
<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><a href=#the-figure-element>figure</a></code> elements are used
to provide both a group caption and individual captions for each
figure in the group:</p>

<pre>&lt;figure&gt;
&lt;figcaption&gt;The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption&gt;
&lt;figure&gt;
&lt;figcaption&gt;Etching. Anonymous, ca. 1423.&lt;/figcaption&gt;
&lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it."&gt;
&lt;/figure&gt;
&lt;figure&gt;
&lt;figcaption&gt;Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption&gt;
&lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls."&gt;
&lt;/figure&gt;
&lt;figure&gt;
&lt;figcaption&gt;Film photograph. Peter Jankle, 1999.&lt;/figcaption&gt;
&lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece."&gt;
&lt;/figure&gt;
&lt;/figure&gt;</pre>

</div>

<!--FORK--><!--TITLE-->
<div class=example>

<p>The previous example could also be more succintly written as
follows (using <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes in
place of the nested <code><a href=#the-figure-element>figure</a></code>/<code><a href=#the-figcaption-element>figcaption</a></code>
pairs):</p>

<pre>&lt;figure&gt;
&lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
&lt;/figure&gt;</pre>

</div>
<!--FORK--><!--TITLE-->


<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
caption information for the image, derived as follows:</p>

<ol><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
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><a href=#the-title-attribute>title</a></code>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
be met as well:</p>

<ul><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
present and has a non-empty value.</li>
<!--FORK--><!--TITLE-->

<li id=figcaption-as-alt-condition>The <code><a href=#the-img-element>img</a></code> element
is in a <code><a href=#the-figure-element>figure</a></code> element that contains a
the conditions listed below applies:</p>

<ul><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
and has a non-empty value (as <a href=#unknown-images>described
above</a>).</li>
<!--FORK--><!--TITLE-->

<li>The <code><a href=#the-img-element>img</a></code> element is in a <code><a href=#the-figure-element>figure</a></code>
element that satisfies <a href=#figcaption-as-alt-condition>the
<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>

<!--FORK--><!--TITLE-->
<hr><p>For short inline annotations, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute should be used.</p>

<div class=example>
closing for lunch&lt;/span&gt;.</pre>

</div>
<!--FORK--><!--TITLE-->

<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>
<hr><p>For
<!--FORK--><!--TITLE-->
longer
<!--FORK--><!--TITLE-->
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>

<div class=example>

68 index

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 17 April 2012</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 18 April 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
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><a href=#the-title-attribute>title</a></code>
attribute, and makes using the <code title=attr-title><a href=#the-title-attribute>title</a></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>

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 <a href=#interactive-content>interactive
content</a>, 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><a href=#the-title-attribute>title</a></code> attribute of the
<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><a href=#the-figure-element>figure</a></code> elements are used
to provide both a group caption and individual captions for each
figure in the group:</p>

<pre>&lt;figure&gt;
&lt;figcaption&gt;The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption&gt;
&lt;figure&gt;
&lt;figcaption&gt;Etching. Anonymous, ca. 1423.&lt;/figcaption&gt;
&lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it."&gt;
&lt;/figure&gt;
&lt;figure&gt;
&lt;figcaption&gt;Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption&gt;
&lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls."&gt;
&lt;/figure&gt;
&lt;figure&gt;
&lt;figcaption&gt;Film photograph. Peter Jankle, 1999.&lt;/figcaption&gt;
&lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece."&gt;
&lt;/figure&gt;
&lt;/figure&gt;</pre>

</div>

<!--FORK--><!--TITLE-->
<div class=example>

<p>The previous example could also be more succintly written as
follows (using <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes in
place of the nested <code><a href=#the-figure-element>figure</a></code>/<code><a href=#the-figcaption-element>figcaption</a></code>
pairs):</p>

<pre>&lt;figure&gt;
&lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
&lt;/figure&gt;</pre>

</div>
<!--FORK--><!--TITLE-->


<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
caption information for the image, derived as follows:</p>

<ol><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
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><a href=#the-title-attribute>title</a></code>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
be met as well:</p>

<ul><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
present and has a non-empty value.</li>
<!--FORK--><!--TITLE-->

<li id=figcaption-as-alt-condition>The <code><a href=#the-img-element>img</a></code> element
is in a <code><a href=#the-figure-element>figure</a></code> element that contains a
the conditions listed below applies:</p>

<ul><!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
and has a non-empty value (as <a href=#unknown-images>described
above</a>).</li>
<!--FORK--><!--TITLE-->

<li>The <code><a href=#the-img-element>img</a></code> element is in a <code><a href=#the-figure-element>figure</a></code>
element that satisfies <a href=#figcaption-as-alt-condition>the
<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>

<!--FORK--><!--TITLE-->
<hr><p>For short inline annotations, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute should be used.</p>

<div class=example>
closing for lunch&lt;/span&gt;.</pre>

</div>
<!--FORK--><!--TITLE-->

<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>
<hr><p>For
<!--FORK--><!--TITLE-->
longer
<!--FORK--><!--TITLE-->
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>

<div class=example>

0 comments on commit 4c98a1d

Please sign in to comment.
You can’t perform that action at this time.