- From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 21 Sep 2012 08:14:15 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv342 Modified Files: commands.html common-input-element-attributes.html global-attributes.html index.html introduction.html links.html media-elements.html obsolete.html rendering.html single-page.html spec.html the-abbr-element.html the-command-element.html the-dfn-element.html the-div-element.html the-img-element.html the-link-element.html the-meter-element.html the-style-element.html the-textarea-element.html Log Message: commit db7166e3d45c1c28ec8c6c2f73db0383aa75a3f5 Merge: 68b1f03 7202112 Author: Silvia Pfeiffer <silviapfeiffer1@gmail.com> Date: Fri Sep 21 17:43:46 2012 +1000 Merge branch 'feature/whatwg_title' Index: media-elements.html =================================================================== RCS file: /sources/public/html5/spec/media-elements.html,v retrieving revision 1.185 retrieving revision 1.186 diff -u -d -r1.185 -r1.186 --- media-elements.html 21 Sep 2012 00:14:00 -0000 1.185 +++ media-elements.html 21 Sep 2012 08:14:11 -0000 1.186 @@ -6660,7 +6660,7 @@ several times). If a <a href="#media-resource">media resource</a>'s audio track exposed in this way has no known name, and it is the only audio track for a particular <a href="#media-element">media element</a>, the user agent - should use the element's <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + should use the element's <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute, if any, as the name (or as part of the name) of that track.</p> Index: links.html =================================================================== RCS file: /sources/public/html5/spec/links.html,v retrieving revision 1.288 retrieving revision 1.289 diff -u -d -r1.288 -r1.289 --- links.html 21 Sep 2012 00:14:00 -0000 1.288 +++ links.html 21 Sep 2012 08:14:11 -0000 1.289 @@ -1212,7 +1212,7 @@ <p>If the <code title="rel-alternate"><a href="#rel-alternate">alternate</a></code> keyword is also specified on the <code><a href="the-link-element.html#the-link-element">link</a></code> element, then <dfn id="the-link-is-an-alternative-stylesheet">the link - is an alternative stylesheet</dfn>; in this case, the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute must be specified on the + is an alternative stylesheet</dfn>; in this case, the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute must be specified on the <code><a href="the-link-element.html#the-link-element">link</a></code> element, with a non-empty value.</p> <p>The default type for resources given by the <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword is <code title="">text/css</code>.</p> @@ -1717,7 +1717,7 @@ <li class="tag-cloud-5"><a title="41 instances" href="/t/pear">pear</a> <span>(very popular)</span> </ul></pre> - <p>The actual frequency of each tag is given using the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute. A CSS style sheet is + <p>The actual frequency of each tag is given using the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute. A CSS style sheet is provided to convert the markup into a cloud of differently-sized words, but for user agents that do not support CSS or are not visual, the markup contains annotations like "(popular)" or Index: index.html =================================================================== RCS file: /sources/public/html5/spec/index.html,v retrieving revision 1.1302 retrieving revision 1.1303 diff -u -d -r1.1302 -r1.1303 --- index.html 21 Sep 2012 00:14:00 -0000 1.1302 +++ index.html 21 Sep 2012 08:14:11 -0000 1.1303 @@ -2472,7 +2472,7 @@ </td><td> <a href="browsers.html#browsing-context">Browsing context</a> for <a href="constraints.html#form-submission-0">form submission</a> </td><td> <a href="browsers.html#valid-browsing-context-name-or-keyword">Valid browsing context name or keyword</a> </td></tr><tr><th> <code title="">title</code> - </th><td> <a href="global-attributes.html#the-title-attribute" title="attr-title">HTML elements</a> + </th><td> <a href="global-attributes.html#attr-title" title="attr-title">HTML elements</a> </td><td> Advisory information for the element </td><td> <a href="element-definitions.html#attribute-text">Text</a> </td></tr><tr><th> <code title="">title</code> Index: the-img-element.html =================================================================== RCS file: /sources/public/html5/spec/the-img-element.html,v retrieving revision 1.183 retrieving revision 1.184 diff -u -d -r1.183 -r1.184 --- the-img-element.html 21 Sep 2012 00:14:06 -0000 1.183 +++ the-img-element.html 21 Sep 2012 08:14:12 -0000 1.184 @@ -405,6 +405,10 @@ --><!--FORK--><!-- -->.</p> + <p>The requirements on the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> + attribute's value are described <a href="#alt">in the next + section</a>.</p> + <p>The <code title="attr-img-src"><a href="#attr-img-src">src</a></code> attribute must be present, and must contain a <a href="urls.html#valid-non-empty-url-potentially-surrounded-by-spaces">valid non-empty URL potentially surrounded by spaces</a> referencing a non-interactive, @@ -413,24 +417,21 @@ - <p class="note">Images can thus be static bitmaps (e.g. PNGs, GIFs, - JPEGs), single-page vector documents (single-page PDFs, XML files - with an SVG root element), animated bitmaps (APNGs, animated GIFs), - animated vector graphics (XML files with an SVG root element that - use declarative SMIL animation), and so forth. However, this also - precludes SVG files with script, multipage PDF files, interactive - MNG files, HTML documents, plain text documents, and so forth.</p> - - <p>The requirements on the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> - attribute's value are described <a href="#alt">in the next - section</a>.</p> + <p class="note">The requirements above imply that images can be + static bitmaps (e.g. PNGs, GIFs, JPEGs), single-page vector + documents (single-page PDFs, XML files with an SVG root element), + animated bitmaps (APNGs, animated GIFs), animated vector graphics + (XML files with an SVG root element that use declarative SMIL + animation), and so forth. However, these definitions preclude SVG + files with script, multipage PDF files, interactive MNG files, HTML + documents, plain text documents, and so forth.</p> <p>The <code><a href="#the-img-element">img</a></code> element must not be used as a layout tool. In particular, <code><a href="#the-img-element">img</a></code> elements should not be used to display transparent images, as they rarely convey meaning and rarely add anything useful to the document.</p> - <p>The <dfn id="attr-img-crossorigin" title="attr-img-crossorigin"><code>crossorigin</code></dfn> + <hr><p>The <dfn id="attr-img-crossorigin" title="attr-img-crossorigin"><code>crossorigin</code></dfn> attribute is a <a href="urls.html#cors-settings-attribute">CORS settings attribute</a>. Its purpose is to allow images from third-party sites that allow cross-origin access to be used with <code><a href="the-canvas-element.html#the-canvas-element">canvas</a></code>.</p> @@ -467,13 +468,15 @@ <p>A user agent that obtains images immediately must synchronously <a href="#update-the-image-data">update the image data</a> of an <code><a href="#the-img-element">img</a></code> element - whenever that element is created with a <code title="attr-img-src"><a href="#attr-img-src">src</a></code> attribute, + whenever that element is created with a <code title="attr-img-src"><a href="#attr-img-src">src</a></code> attribute + . A user agent that obtains images immediately must also synchronously <a href="#update-the-image-data">update the image data</a> of an <code><a href="#the-img-element">img</a></code> element whenever that element has its <code title="attr-img-src"><a href="#attr-img-src">src</a></code>, + or <code title="attr-img-crossorigin"><a href="#attr-img-crossorigin">crossorigin</a></code> attribute set, changed, or removed.</p> <!-- Note how this does NOT happen when the base URL changes. --> @@ -488,6 +491,7 @@ element's <code title="attr-img-src"><a href="#attr-img-src">src</a></code>, + or <code title="attr-img-crossorigin"><a href="#attr-img-crossorigin">crossorigin</a></code> attribute set, changed, or removed, if the user agent only obtains images on demand, the <code><a href="#the-img-element">img</a></code> element must return to the <a href="#img-none" title="img-none">unavailable</a> state.</p> <!-- Note how this @@ -587,6 +591,7 @@ multiple requests when, for example, the <code title="attr-img-src"><a href="#attr-img-src">src</a></code>, + and <code title="attr-img-crossorigin"><a href="#attr-img-crossorigin">crossorigin</a></code> attributes are all set in succession.</p> @@ -788,7 +793,8 @@ 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"><a href="global-attributes.html#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 --><!-- NOTE: the order of these steps is important; it's intended + to make the innermost caption override the outer ones --><li><p>If the image has a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute whose value is not the empty string, then the value of that attribute is the caption information; abort these steps.</p></li> @@ -803,6 +809,8 @@ <code><a href="the-figcaption-element.html#the-figcaption-element">figcaption</a></code> element are the caption information; abort these steps.</p></li> + <li><p>There is no caption information.</p></li> + </ol></dd> <dt>If the <code title="attr-img-src"><a href="#attr-img-src">src</a></code> attribute is not @@ -826,14 +834,14 @@ </dl><p>The <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute does not represent advisory information. User agents must not present the contents of the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute in - the same way as content of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + the same way as content of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute.</p> <p>User agents may always provide the user with the option to display any image, or to prevent any image from being displayed. - <!--POLITICS--><!--FORK--> +<!--POLITICS--><!--FORK--> </p> @@ -870,7 +878,7 @@ <div class="impl"> <p>The <dfn id="dom-img-alt" title="dom-img-alt"><code>alt</code></dfn>, <dfn id="dom-img-src" title="dom-img-src"><code>src</code></dfn>, - + IDL attributes must <a href="common-dom-interfaces.html#reflect">reflect</a> the respective content attributes of the same name.</p> @@ -1019,7 +1027,7 @@ <p>Here it is not known at the time of publication what the image will be, only that it will be a coat of arms of some kind, and thus no replacement text can be provided, and instead only a brief - caption for the image is provided, in the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute:</p> + caption for the image is provided, in the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute:</p> <pre><p>The last user to have uploaded a coat of arms uploaded this one:</p> <p><img src="last-uploaded-coat-of-arms.cgi" title="User-uploaded coat of arms."></p></pre> @@ -1106,7 +1114,7 @@ contain text that could be considered the image's <em><a href="the-caption-element.html#the-caption-element">caption</a></em>, <em><a href="the-title-element.html#the-title-element">title</a></em>, or <em><a href="the-legend-element.html#the-legend-element">legend</a></em>. It is supposed to contain replacement text that could be used by users <em>instead</em> of the - image; it is not meant to supplement the image. The <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute can be used for + image; it is not meant to supplement the image. The <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute can be used for supplemental information.</p> <p>Another corollary is that the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute's value should not repeat @@ -1238,7 +1246,7 @@ <p>Text such as "Photo of white house with boarded door" would be equally bad alternative text (though it could be suitable for the - <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute or in the + <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute or in the <code><a href="the-figcaption-element.html#the-figcaption-element">figcaption</a></code> element of a <code><a href="the-figure-element.html#the-figure-element">figure</a></code> with this image).</p> @@ -1423,7 +1431,7 @@ <p>In these cases, it would be wrong to include alternative text that consists of just a caption. If a caption is to be included, - then either the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute can + then either the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute can be used, or the <code><a href="the-figure-element.html#the-figure-element">figure</a></code> and <code><a href="the-figcaption-element.html#the-figcaption-element">figcaption</a></code> elements can be used. In the latter case, the image would in fact be a phrase or paragraph with an alternative graphical @@ -1505,6 +1513,7 @@ <!--FORK--> + <h6 id="a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with no links</h6> <p>When a picture has been sliced into smaller image files that are @@ -1720,15 +1729,30 @@ be met as well:</p> <ul><!-- when editing this list, search for the two other occurrences - of 'critical-no-alt' --><!--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.html#the-figure-element">figure</a></code> element that contains a + of 'critical-no-alt' --><!-- NOTE: the order of these steps is important; it's intended + to encourage using <figcaption> rather than title="" --><li id="figcaption-as-alt-condition"><p>The <code><a href="#the-img-element">img</a></code> + element is in a <code><a href="the-figure-element.html#the-figure-element">figure</a></code> element that contains a <code><a href="the-figcaption-element.html#the-figcaption-element">figcaption</a></code> element that contains content other than <a href="content-models.html#inter-element-whitespace">inter-element whitespace</a>, and, ignoring the <code><a href="the-figcaption-element.html#the-figcaption-element">figcaption</a></code> element and its descendants, the <code><a href="the-figure-element.html#the-figure-element">figure</a></code> element has no <code><a href="infrastructure.html#text-0">Text</a></code> node descendants other than <a href="content-models.html#inter-element-whitespace">inter-element whitespace</a>, and no <a href="content-models.html#embedded-content-2">embedded content</a> descendant other than the - <code><a href="#the-img-element">img</a></code> element.</li> + <code><a href="#the-img-element">img</a></code> element.</p></li> + + <li> + +<!--FORK--><!--TITLE--> + + <!-- search for title-warning if modifying this paragraph --> + <p class="note">Relying on the <code title="attr-title"><a href="global-attributes.html#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> </ul><p class="note">Such cases are to be kept to an absolute minimum. If there is even the slightest possibility of the author @@ -1793,7 +1817,7 @@ description is not available, and the user is to provide the description. For instance, the point of a CAPTCHA image is to see if the user can literally read the graphic. Here is one way to - mark up a CAPTCHA (note the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + mark up a CAPTCHA (note the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute):</p> <pre><p><label>What does this image say? @@ -1820,7 +1844,7 @@ </table></pre> <p>Notice that even in this example, as much useful information - as possible is still included in the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute.</p> + as possible is still included in the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute.</p> </div> @@ -1855,7 +1879,6 @@ - <div class="impl"> <h6 id="guidance-for-markup-generators"><span class="secno">4.8.1.1.12 </span>Guidance for markup generators</h6> @@ -1899,10 +1922,12 @@ the conditions listed below applies:</p> <ul><!-- when editing this list, search for the two other occurrences - of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code><a href="#the-img-element">img</a></code> element is in a <code><a href="the-figure-element.html#the-figure-element">figure</a></code> + of 'critical-no-alt' --><li>The <code><a href="#the-img-element">img</a></code> element is in a <code><a href="the-figure-element.html#the-figure-element">figure</a></code> element that satisfies <a href="#figcaption-as-alt-condition">the conditions described above</a>.</li> +<!--FORK--><!--TITLE--> + <!-- the following are additional entries not included in the aforementioned list, as they apply only to conformance checkers --> Index: commands.html =================================================================== RCS file: /sources/public/html5/spec/commands.html,v retrieving revision 1.235 retrieving revision 1.236 diff -u -d -r1.235 -r1.236 --- commands.html 21 Sep 2012 00:13:57 -0000 1.235 +++ commands.html 21 Sep 2012 08:14:10 -0000 1.236 @@ -604,7 +604,7 @@ attribute.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + is the value of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of the element. If the attribute is not present, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> is the empty string.</p> <p>The <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> of the command @@ -685,7 +685,7 @@ attribute, if present, is the <a href="#command-facet-label" title="command-facet-Label">Label</a>. Otherwise, the <a href="#command-facet-label" title="command-facet-Label">Label</a> is the empty string.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + is the value of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of the <code><a href="the-input-element.html#the-input-element">input</a></code> element. If the attribute is not present, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> is the empty string.</p> @@ -750,7 +750,7 @@ U+0020 SPACE character.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the string given by the element's <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute, if any, and the empty + is the string given by the element's <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute, if any, and the empty string if the attribute is absent.</p> <p>There is no <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the @@ -853,9 +853,9 @@ is the <a href="#command-facet-label" title="command-facet-Label">Label</a> of the <a href="the-command-element.html#master-command">master command</a>.</p> - <p>If the element has a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + <p>If the element has a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute, then the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of - the command is the value of that <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute. Otherwise, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command is the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the <a href="the-command-element.html#master-command">master + the command is the value of that <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute. Otherwise, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command is the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the <a href="the-command-element.html#master-command">master command</a>.</p> <p>The <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> of the command @@ -905,7 +905,7 @@ attribute.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + is the value of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of the element.</p> <p>There is no <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the @@ -946,7 +946,7 @@ attribute.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + is the value of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of the element.</p> <p>There is no <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the @@ -996,7 +996,7 @@ <code><a href="infrastructure.html#textcontent">textContent</a></code> of the element itself.</p> <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + is the value of the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of the element. If the attribute is not present, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> is the empty string.</p> <p>There is no <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the Index: the-link-element.html =================================================================== RCS file: /sources/public/html5/spec/the-link-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-link-element.html 21 Sep 2012 00:14:06 -0000 1.182 +++ the-link-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -643,7 +643,7 @@ <p class="note">The <code title="attr-link-title"><a href="#attr-link-title">title</a></code> attribute on <code><a href="#the-link-element">link</a></code> elements differs from the global - <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute of most other + <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of most other elements in that a link without a title does not inherit the title of the parent element: it merely has no title.</p> Index: the-textarea-element.html =================================================================== RCS file: /sources/public/html5/spec/the-textarea-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-textarea-element.html 21 Sep 2012 00:14:08 -0000 1.182 +++ the-textarea-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -622,7 +622,7 @@ description of the expected format. The attribute, if specified, must have a value that contains no "LF" (U+000A) or "CR" (U+000D) characters.</p> - <p class="note">For a longer hint or other advisory text, the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute is more appropriate.</p> + <p class="note">For a longer hint or other advisory text, the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute is more appropriate.</p> <p>The <code title="attr-textarea-placeholder"><a href="#attr-textarea-placeholder">placeholder</a></code> attribute should not be used as an alternative to a Index: the-dfn-element.html =================================================================== RCS file: /sources/public/html5/spec/the-dfn-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-dfn-element.html 21 Sep 2012 00:14:04 -0000 1.182 +++ the-dfn-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -373,7 +373,7 @@ <code><a href="#the-dfn-element">dfn</a></code> element is present, then it must contain only the term being defined.</p> - <p class="note">The <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute + <p class="note">The <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of ancestor elements does not affect <code><a href="#the-dfn-element">dfn</a></code> elements.</p> <p>An <code><a href="the-a-element.html#the-a-element">a</a></code> element that links to a <code><a href="#the-dfn-element">dfn</a></code> Index: rendering.html =================================================================== RCS file: /sources/public/html5/spec/rendering.html,v retrieving revision 1.253 retrieving revision 1.254 diff -u -d -r1.253 -r1.254 --- rendering.html 21 Sep 2012 00:14:01 -0000 1.253 +++ rendering.html 21 Sep 2012 08:14:11 -0000 1.254 @@ -2822,30 +2822,34 @@ - <h4 id="the-title-attribute-0"><span class="secno">10.7.2 </span>The <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute</h4> + <h4 id="the-title-attribute-0"><span class="secno">10.7.2 </span>The <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute</h4> - <p>Given an element (e.g. the element designated by the mouse - cursor), if the element, or one of its ancestors, has a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute, and the nearest such - attribute has a value that is not the empty string, it is expected - that the user agent will expose the contents of that attribute as a - tooltip.</p> + <p>User agents are expected to expose the <a href="global-attributes.html#advisory-information">advisory + 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 + user is unable to use a pointing device, then the user agent is + expected to make the content available in some other fashion, e.g. + by making the element focusable and always displaying the + <a href="global-attributes.html#advisory-information">advisory information</a> of the currently focused element, + or by showing the <a href="global-attributes.html#advisory-information">advisory information</a> of the elements + under the user's finger on a touch device as the user pans around + the screen.</p> <p>"LF" (U+000A) characters are expected to cause line - breaks in the tooltip, "tab" (U+0009) characters + breaks in the tooltip; "tab" (U+0009) characters are expected to render as a non-zero horizontal shift that lines up the next glyph with the next tab stop, with tab stops occurring at points that are multiples of 8 times the width of a U+0020 SPACE character.</p> - <p>User agents are encouraged to make it possible to view tooltips - without the use of a pointing device, since not all users are able - to use pointing devices.</p> - <div class="example"> <p>For example, a visual user agent could make elements with a - <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute focusable, and - could make any focused element with a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute show its tooltip under + <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute focusable, and + could make any focused element with a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute show its tooltip under the element while the element has focus. This would allow a user to tab around the document to find all the advisory text.</p> Index: the-abbr-element.html =================================================================== RCS file: /sources/public/html5/spec/the-abbr-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-abbr-element.html 21 Sep 2012 00:14:03 -0000 1.182 +++ the-abbr-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -428,23 +428,23 @@ is expected to be useful in the following cases:</p> <ul><li>Abbreviations for which the author wants to give expansions, - where using the <code><a href="#the-abbr-element">abbr</a></code> element with a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute is an alternative to + where using the <code><a href="#the-abbr-element">abbr</a></code> element with a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute is an alternative to including the expansion inline (e.g. in parentheses).</li> <li>Abbreviations that are likely to be unfamiliar to the document's readers, for which authors are encouraged to either mark - up the abbreviation using an <code><a href="#the-abbr-element">abbr</a></code> element with a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute or include the expansion + up the abbreviation using an <code><a href="#the-abbr-element">abbr</a></code> element with a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute or include the expansion inline in the text the first time the abbreviation is used.</li> <li>Abbreviations whose presence needs to be semantically annotated, e.g. so that they can be identified from a style sheet and given specific styles, for which the <code><a href="#the-abbr-element">abbr</a></code> element - can be used without a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + can be used without a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute.</li> - </ul><p title="note">Providing an expansion in a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute once will not necessarily + </ul><p title="note">Providing an expansion in a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute once will not necessarily cause other <code><a href="#the-abbr-element">abbr</a></code> elements in the same document with the - same contents but without a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + same contents but without a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute to behave as if they had the same expansion. Every <code><a href="#the-abbr-element">abbr</a></code> element is independent.</p> Index: spec.html =================================================================== RCS file: /sources/public/html5/spec/spec.html,v retrieving revision 1.2001 retrieving revision 1.2002 diff -u -d -r1.2001 -r1.2002 --- spec.html 21 Sep 2012 00:14:02 -0000 1.2001 +++ spec.html 21 Sep 2012 08:14:12 -0000 1.2002 @@ -583,7 +583,7 @@ <li><a href="elements.html#elements-in-the-dom"><span class="secno">3.2.2 </span>Elements in the DOM</a></li> <li><a href="global-attributes.html#global-attributes"><span class="secno">3.2.3 </span>Global attributes</a> <ol class="toc"><li><a href="global-attributes.html#the-id-attribute"><span class="secno">3.2.3.1 </span>The <code>id</code> attribute</a></li> - <li><a href="global-attributes.html#the-title-attribute"><span class="secno">3.2.3.2 </span>The <code>title</code> attribute</a></li> + <li><a href="global-attributes.html#the-title-attribute"><span class="secno">3.2.3.2 </span>The <code title="attr-title">title</code> attribute</a></li> <li><a href="global-attributes.html#the-lang-and-xml:lang-attributes"><span class="secno">3.2.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li> <li><a href="global-attributes.html#the-translate-attribute"><span class="secno">3.2.3.4 </span>The <code title="attr-translate">translate</code> attribute</a></li> <li><a href="global-attributes.html#the-xml:base-attribute-(xml-only)"><span class="secno">3.2.3.5 </span>The <code>xml:base</code> Index: global-attributes.html =================================================================== RCS file: /sources/public/html5/spec/global-attributes.html,v retrieving revision 1.185 retrieving revision 1.186 diff -u -d -r1.185 -r1.186 --- global-attributes.html 21 Sep 2012 00:13:59 -0000 1.185 +++ global-attributes.html 21 Sep 2012 08:14:10 -0000 1.186 @@ -334,7 +334,7 @@ <a href="spec.html#contents">Table of contents</a> – <a href="element-definitions.html">3.2.4 Element definitions →</a> <ol class="toc"><li><ol><li><ol><li><a href="global-attributes.html#global-attributes"><span class="secno">3.2.3 </span>Global attributes</a> - <ol><li><a href="global-attributes.html#the-id-attribute"><span class="secno">3.2.3.1 </span>The <code>id</code> attribute</a></li><li><a href="global-attributes.html#the-title-attribute"><span class="secno">3.2.3.2 </span>The <code>title</code> attribute</a></li><li><a href="global-attributes.html#the-lang-and-xml:lang-attributes"><span class="secno">3.2.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li><li><a href="global-attributes.html#the-translate-attribute"><span class="secno">3.2.3.4 </span>The <code title="attr-translate">translate</code> attribute</a></li><li><a href="global-attributes.html#the-xml:base-attribute-(xml-only)"><span class="secno">3.2.3.5 </span>The <code>xml:base</code> + <ol><li><a href="global-attributes.html#the-id-attribute"><span class="secno">3.2.3.1 </span>The <code>id</code> attribute</a></li><li><a href="global-attributes.html#the-title-attribute"><span class="secno">3.2.3.2 </span>The <code title="attr-title">title</code> attribute</a></li><li><a href="global-attributes.html#the-lang-and-xml:lang-attributes"><span class="secno">3.2.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li><li><a href="global-attributes.html#the-translate-attribute"><span class="secno">3.2.3.4 </span>The <code title="attr-translate">translate</code> attribute</a></li><li><a href="global-attributes.html#the-xml:base-attribute-(xml-only)"><span class="secno">3.2.3.5 </span>The <code>xml:base</code> attribute (XML only)</a></li><li><a href="global-attributes.html#the-dir-attribute"><span class="secno">3.2.3.6 </span>The <code>dir</code> attribute</a></li><li><a href="global-attributes.html#classes"><span class="secno">3.2.3.7 </span>The <code>class</code> attribute</a></li><li><a href="global-attributes.html#the-style-attribute"><span class="secno">3.2.3.8 </span>The <code>style</code> attribute</a></li><li><a href="global-attributes.html#embedding-custom-non-visible-data-with-the-data-*-attributes"><span class="secno">3.2.3.9 </span>Embedding custom non-visible data with the <code title="attr-data-*">data-*</code> attributes</a></li></ol></li></ol></li></ol></li></ol></div> <h4 id="global-attributes"><span class="secno">3.2.3 </span><dfn>Global attributes</dfn></h4> @@ -358,7 +358,7 @@ <li><code title="attr-spellcheck"><a href="editing-apis.html#attr-spellcheck">spellcheck</a></code></li> <li><code title="attr-style"><a href="#the-style-attribute">style</a></code></li> <li><code title="attr-tabindex"><a href="editing.html#attr-tabindex">tabindex</a></code></li> - <li><code title="attr-title"><a href="#the-title-attribute">title</a></code></li> + <li><code title="attr-title"><a href="#attr-title">title</a></code></li> <li><code title="attr-translate"><a href="#attr-translate">translate</a></code></li> </ul><div class="impl"> @@ -522,9 +522,9 @@ </div> - <h5 id="the-title-attribute"><span class="secno">3.2.3.2 </span>The <dfn title="attr-title"><code>title</code></dfn> attribute</h5> + <h5 id="the-title-attribute"><span class="secno">3.2.3.2 </span>The <code title="attr-title"><a href="#attr-title">title</a></code> attribute</h5> - <p>The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute + <p>The <dfn id="attr-title" title="attr-title"><code>title</code></dfn> attribute <a href="rendering.html#represents">represents</a> 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 @@ -534,40 +534,72 @@ content</a>, it could be a label for, or instructions for, use of the element; and so forth. The value is text.</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 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="#the-title-attribute">title</a></code> attribute of the + that the <code title="attr-title"><a href="#attr-title">title</a></code> attribute of the nearest ancestor <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a> - with a <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute set is also + with a <code title="attr-title"><a href="#attr-title">title</a></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> - <p>If the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute's value + <p>If the <code title="attr-title"><a href="#attr-title">title</a></code> attribute's value contains "LF" (U+000A) characters, the content is split into multiple lines. Each "LF" (U+000A) character represents a line break.</p> <div class="example"> - <p>Caution is advised with respect to the use of newlines in <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes.</p> + <p>Caution is advised with respect to the use of newlines in <code title="attr-title"><a href="#attr-title">title</a></code> attributes.</p> <p>For instance, the following snippet actually defines an abbreviation's expansion <em>with a line break in it</em>:</p> <pre class="bad"><p>My logs show that there was some interest in <abbr title="Hypertext -Transport Protocol">HTTP</abbr> today.</p></pre> +Transport Protocol">HTTP</abbr> today.</p></pre> <!-- DO NOT REWRAP THIS LINE --> </div> <p>Some elements, such as <code><a href="the-link-element.html#the-link-element">link</a></code>, <code><a href="the-abbr-element.html#the-abbr-element">abbr</a></code>, and - <code><a href="the-input-element.html#the-input-element">input</a></code>, define additional semantics for the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute beyond the semantics - described above.</p> + <code><a href="the-input-element.html#the-input-element">input</a></code>, define additional semantics for the <code title="attr-title"><a href="#attr-title">title</a></code> attribute beyond the semantics + described above.</p> <!-- the other two are <code>style</code> and + <code>dfn</code> --> <div class="impl"> + <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. 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.html#the-link-element">link</a></code>, <code><a href="the-style-element.html#the-style-element">style</a></code>, + <code><a href="the-dfn-element.html#the-dfn-element">dfn</a></code>, <code><a href="the-abbr-element.html#the-abbr-element">abbr</a></code>, or <code><a href="the-title-element.html#the-title-element">title</a></code> element, + then: if the element has a <code title="">title</code> attribute, <!-- not attr-title --> + return the value of that attribute, otherwise, return the empty + string.</p></li> <!-- note: <code>input</code> doesn't do this --> + + <li><p>Otherwise, if the element has a <code title="attr-title="><a href="#attr-title">title</a></code> attribute, then return its + value.</p></li> + + <li><p>Otherwise, if the element has a parent element, then return + the parent element's <a href="#advisory-information">advisory information</a>.</p></li> + + <li><p>Otherwise, return the empty string.</p></li> + + </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="common-dom-interfaces.html#reflect">reflect</a> the <code title="attr-title"><a href="#the-title-attribute">title</a></code> + must <a href="common-dom-interfaces.html#reflect">reflect</a> the <code title="attr-title"><a href="#attr-title">title</a></code> content attribute.</p> </div> Index: the-command-element.html =================================================================== RCS file: /sources/public/html5/spec/the-command-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-command-element.html 21 Sep 2012 00:14:04 -0000 1.182 +++ the-command-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -387,7 +387,7 @@ <code title="attr-command-checked"><a href="#attr-command-checked">checked</a></code>, <code title="attr-command-radiogroup"><a href="#attr-command-radiogroup">radiogroup</a></code>, <!--<code title="attr-command-default">default</code>,--> and - <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attributes defines a new + <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attributes defines a new command. A <code><a href="#the-command-element">command</a></code> element that uses the <code title="attr-command-command"><a href="#attr-command-command">command</a></code> <em>attribute</em> defines a command by reference to another one. This allows authors to define a command once, and set its state (e.g. whether it is Index: single-page.html =================================================================== RCS file: /sources/public/html5/spec/single-page.html,v retrieving revision 1.130 retrieving revision 1.131 diff -u -d -r1.130 -r1.131 --- single-page.html 21 Sep 2012 00:14:01 -0000 1.130 +++ single-page.html 21 Sep 2012 08:14:11 -0000 1.131 @@ -603,7 +603,7 @@ <li><a href=#global-attributes><span class=secno>3.2.3 </span>Global attributes</a> <ol class=toc> <li><a href=#the-id-attribute><span class=secno>3.2.3.1 </span>The <code>id</code> attribute</a></li> - <li><a href=#the-title-attribute><span class=secno>3.2.3.2 </span>The <code>title</code> attribute</a></li> + <li><a href=#the-title-attribute><span class=secno>3.2.3.2 </span>The <code title=attr-title>title</code> attribute</a></li> <li><a href=#the-lang-and-xml:lang-attributes><span class=secno>3.2.3.3 </span>The <code title=attr-lang>lang</code> and <code title=attr-xml-lang>xml:lang</code> attributes</a></li> <li><a href=#the-translate-attribute><span class=secno>3.2.3.4 </span>The <code title=attr-translate>translate</code> attribute</a></li> <li><a href=#the-xml:base-attribute-(xml-only)><span class=secno>3.2.3.5 </span>The <code>xml:base</code> @@ -1384,6 +1384,64 @@ <li><a class=no-num href=#acknowledgements>Acknowledgements</a></li></ol> <!--end-toc--> <hr><h2 id=introduction><span class=secno>1 </span>Introduction</h2> + + <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><a href=#the-form-element>form</a></code> element's <code title=attr-fs-method><a href=#attr-fs-method>method</a></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--> + <li>An experimental specification of the legacy <code title=dom-find>window.find()</code> API.</li><!--FIND--> + <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li> + <li>The <code>data</code> element for marking up machine-readable data.</li><!--DATA--><!--FORK--> + <li>The <code title=scheme-http+aes>http+aes:</code> and <code title=scheme-http+aes>https+aes:</code> schemes.</li><!--FORK--> + <li>The <a href=#application-cache>application cache</a> feature's <span title=concept-appcache-mode-prefer-online>prefer-online</span> mode.</li><!--FORK--><!--APPCACHE-PREFER-ONLINE--> + + +<!-- + <p>Features that are part of the WHATWG HTML Living Standard + specification but that are currently published as separate + specifications as well, and are not included in the W3C HTML5 + specification, consist of:</p> + + <ul> + <li><a href="#2dcontext">Canvas 2D Graphics Context</a>--><!--2DCONTEXT--><!-- + <li><a href="#microdata">Microdata</a>--><!--MD--><!-- + <li><a href="#crossDocumentMessages">Cross-document messaging</a> (also known as Communications)--><!--POSTMSG--><!-- + <li><a href="#channel-messaging">Channel messaging</a> (also known as Communications)--><!--POSTMSG--><!-- + </ul> +--> + +<!-- + <h6 class="no-toc">What else is HTML5?</h6> + + <p>Features that are not currently published or maintained by the + WHATWG but that are sometimes considered to be informally part of + "HTML5" include:</p> + + <ul> + <li><a href="http://tools.ietf.org/html/rfc6455">WebSocket protocol</a> + <li><a href="http://tools.ietf.org/html/draft-abarth-mime-sniff">Media Type Sniffing</a> + <li><a href="http://tools.ietf.org/html/rfc6454">The Web Origin Concept</a> + <li><a href="http://dev.w3.org/geo/api/spec-source.html">Geolocation API</a> + <li><a href="http://www.w3.org/TR/SVG/">SVG</a> + <li><a href="http://www.w3.org/TR/MathML/">MathML</a> + <li><a href="http://dev.w3.org/2006/webapi/XMLHttpRequest-2/">XMLHttpRequest</a> + <li>Parts of <a href="http://www.w3.org/Style/CSS/current-work">CSS</a> + <li><a href="http://dev.w3.org/html5/webvtt/">WebVTT</a> + </ul> +--> + +<!-- + <p>The <a href="#forms">forms</a> part of this specification was + previously published separately in a specification known as Web + Forms 2. The <a href="#workers">Web Workers</a> section was also + previously published as a separate document.</p> +--> + +<!-- + <p>See also <a + href="http://wiki.whatwg.org/wiki/FAQ#What_are_the_various_versions_of_the_spec.3F">the + relevant FAQ entry</a>.</p> +--> + <!--VERSION--> @@ -10636,7 +10694,7 @@ <li><code title=attr-spellcheck><a href=#attr-spellcheck>spellcheck</a></code></li> <li><code title=attr-style><a href=#the-style-attribute>style</a></code></li> <li><code title=attr-tabindex><a href=#attr-tabindex>tabindex</a></code></li> - <li><code title=attr-title><a href=#the-title-attribute>title</a></code></li> + <li><code title=attr-title><a href=#attr-title>title</a></code></li> <li><code title=attr-translate><a href=#attr-translate>translate</a></code></li> </ul><div class=impl> @@ -10800,9 +10858,9 @@ </div> - <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <dfn title=attr-title><code>title</code></dfn> attribute</h5> + <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h5> - <p>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + <p>The <dfn id=attr-title title=attr-title><code>title</code></dfn> attribute <a href=#represents>represents</a> 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 @@ -10812,40 +10870,72 @@ content</a>, it could be a label for, or instructions for, use of the element; and so forth. The value is text.</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 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=#the-title-attribute>title</a></code> attribute of the + that the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the nearest ancestor <a href=#html-elements title="HTML elements">HTML element</a> - with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute set is also + with a <code title=attr-title><a href=#attr-title>title</a></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> - <p>If the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute's value + <p>If the <code title=attr-title><a href=#attr-title>title</a></code> attribute's value contains "LF" (U+000A) characters, the content is split into multiple lines. Each "LF" (U+000A) character represents a line break.</p> <div class=example> - <p>Caution is advised with respect to the use of newlines in <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes.</p> + <p>Caution is advised with respect to the use of newlines in <code title=attr-title><a href=#attr-title>title</a></code> attributes.</p> <p>For instance, the following snippet actually defines an abbreviation's expansion <em>with a line break in it</em>:</p> <pre class=bad><p>My logs show that there was some interest in <abbr title="Hypertext -Transport Protocol">HTTP</abbr> today.</p></pre> +Transport Protocol">HTTP</abbr> today.</p></pre> <!-- DO NOT REWRAP THIS LINE --> </div> <p>Some elements, such as <code><a href=#the-link-element>link</a></code>, <code><a href=#the-abbr-element>abbr</a></code>, and - <code><a href=#the-input-element>input</a></code>, define additional semantics for the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute beyond the semantics - described above.</p> + <code><a href=#the-input-element>input</a></code>, define additional semantics for the <code title=attr-title><a href=#attr-title>title</a></code> attribute beyond the semantics + described above.</p> <!-- the other two are <code>style</code> and + <code>dfn</code> --> <div class=impl> + <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. 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, + then: if the element has a <code title="">title</code> attribute, <!-- not attr-title --> + return the value of that attribute, otherwise, return the empty + string.</p></li> <!-- note: <code>input</code> doesn't do this --> + + <li><p>Otherwise, if the element has a <code title="attr-title="><a href=#attr-title>title</a></code> attribute, then return its + value.</p></li> + + <li><p>Otherwise, if the element has a parent element, then return + the parent element's <a href=#advisory-information>advisory information</a>.</p></li> + + <li><p>Otherwise, return the empty string.</p></li> + + </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=#the-title-attribute>title</a></code> + must <a href=#reflect>reflect</a> the <code title=attr-title><a href=#attr-title>title</a></code> content attribute.</p> </div> @@ -14345,7 +14435,7 @@ <p class=note>The <code title=attr-link-title><a href=#attr-link-title>title</a></code> attribute on <code><a href=#the-link-element>link</a></code> elements differs from the global - <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute of most other + <code title=attr-title><a href=#attr-title>title</a></code> attribute of most other elements in that a link without a title does not inherit the title of the parent element: it merely has no title.</p> @@ -15508,12 +15598,12 @@ <p id=title-on-style>The <dfn id=attr-style-title title=attr-style-title><code>title</code></dfn> attribute on <code><a href=#the-style-element>style</a></code> elements defines <a href=#alternative-style-sheet-sets>alternative style sheet sets</a>. If the <code><a href=#the-style-element>style</a></code> element has no <code title=attr-style-title><a href=#attr-style-title>title</a></code> attribute, then it has no - title; the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute of + title; the <code title=attr-title><a href=#attr-title>title</a></code> attribute of ancestors does not apply to the <code><a href=#the-style-element>style</a></code> element. <a href=#refsCSSOM>[CSSOM]</a></p> <p class=note>The <code title=attr-style-title><a href=#attr-style-title>title</a></code> attribute on <code><a href=#the-style-element>style</a></code> elements, like the <code title=attr-link-title><a href=#attr-link-title>title</a></code> attribute on <code><a href=#the-link-element>link</a></code> - elements, differs from the global <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute in that a + elements, differs from the global <code title=attr-title><a href=#attr-title>title</a></code> attribute in that a <code><a href=#the-style-element>style</a></code> block without a title does not inherit the title of the parent element: it merely has no title.</p> @@ -20149,7 +20239,7 @@ <pre class=idl>interface <dfn id=htmldivelement>HTMLDivElement</dfn> : <a href=#htmlelement>HTMLElement</a> {};</pre> </dd> </dl><!--TOPIC:HTML--><p>The <code><a href=#the-div-element>div</a></code> element has no special meaning at all. It - <a href=#represents>represents</a> its children. It can be used with the <code title=attr-class><a href=#classes>class</a></code>, <code title=attr-lang><a href=#attr-lang>lang</a></code>, and <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes to mark up semantics + <a href=#represents>represents</a> its children. It can be used with the <code title=attr-class><a href=#classes>class</a></code>, <code title=attr-lang><a href=#attr-lang>lang</a></code>, and <code title=attr-title><a href=#attr-title>title</a></code> attributes to mark up semantics common to a group of consecutive elements.</p> <p class=note>Authors are strongly encouraged to view the @@ -20925,7 +21015,7 @@ <code><a href=#the-dfn-element>dfn</a></code> element is present, then it must contain only the term being defined.</p> - <p class=note>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + <p class=note>The <code title=attr-title><a href=#attr-title>title</a></code> attribute of ancestor elements does not affect <code><a href=#the-dfn-element>dfn</a></code> elements.</p> <p>An <code><a href=#the-a-element>a</a></code> element that links to a <code><a href=#the-dfn-element>dfn</a></code> @@ -21050,23 +21140,23 @@ is expected to be useful in the following cases:</p> <ul><li>Abbreviations for which the author wants to give expansions, - where using the <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is an alternative to + where using the <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#attr-title>title</a></code> attribute is an alternative to including the expansion inline (e.g. in parentheses).</li> <li>Abbreviations that are likely to be unfamiliar to the document's readers, for which authors are encouraged to either mark - up the abbreviation using an <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute or include the expansion + up the abbreviation using an <code><a href=#the-abbr-element>abbr</a></code> element with a <code title=attr-title><a href=#attr-title>title</a></code> attribute or include the expansion inline in the text the first time the abbreviation is used.</li> <li>Abbreviations whose presence needs to be semantically annotated, e.g. so that they can be identified from a style sheet and given specific styles, for which the <code><a href=#the-abbr-element>abbr</a></code> element - can be used without a <code title=attr-title><a href=#the-title-attribute>title</a></code> + can be used without a <code title=attr-title><a href=#attr-title>title</a></code> attribute.</li> - </ul><p title=note>Providing an expansion in a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute once will not necessarily + </ul><p title=note>Providing an expansion in a <code title=attr-title><a href=#attr-title>title</a></code> attribute once will not necessarily cause other <code><a href=#the-abbr-element>abbr</a></code> elements in the same document with the - same contents but without a <code title=attr-title><a href=#the-title-attribute>title</a></code> + same contents but without a <code title=attr-title><a href=#attr-title>title</a></code> attribute to behave as if they had the same expansion. Every <code><a href=#the-abbr-element>abbr</a></code> element is independent.</p> @@ -23376,6 +23466,10 @@ --><!--FORK--><!-- -->.</p> + <p>The requirements on the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> + attribute's value are described <a href=#alt>in the next + section</a>.</p> + <p>The <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute must be present, and must contain a <a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by spaces</a> referencing a non-interactive, @@ -23384,24 +23478,21 @@ - <p class=note>Images can thus be static bitmaps (e.g. PNGs, GIFs, - JPEGs), single-page vector documents (single-page PDFs, XML files - with an SVG root element), animated bitmaps (APNGs, animated GIFs), - animated vector graphics (XML files with an SVG root element that - use declarative SMIL animation), and so forth. However, this also - precludes SVG files with script, multipage PDF files, interactive - MNG files, HTML documents, plain text documents, and so forth.</p> - - <p>The requirements on the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> - attribute's value are described <a href=#alt>in the next - section</a>.</p> + <p class=note>The requirements above imply that images can be + static bitmaps (e.g. PNGs, GIFs, JPEGs), single-page vector + documents (single-page PDFs, XML files with an SVG root element), + animated bitmaps (APNGs, animated GIFs), animated vector graphics + (XML files with an SVG root element that use declarative SMIL + animation), and so forth. However, these definitions preclude SVG + files with script, multipage PDF files, interactive MNG files, HTML + documents, plain text documents, and so forth.</p> <p>The <code><a href=#the-img-element>img</a></code> element must not be used as a layout tool. In particular, <code><a href=#the-img-element>img</a></code> elements should not be used to display transparent images, as they rarely convey meaning and rarely add anything useful to the document.</p> - <p>The <dfn id=attr-img-crossorigin title=attr-img-crossorigin><code>crossorigin</code></dfn> + <hr><p>The <dfn id=attr-img-crossorigin title=attr-img-crossorigin><code>crossorigin</code></dfn> attribute is a <a href=#cors-settings-attribute>CORS settings attribute</a>. Its purpose is to allow images from third-party sites that allow cross-origin access to be used with <code><a href=#the-canvas-element>canvas</a></code>.</p> @@ -23438,13 +23529,15 @@ <p>A user agent that obtains images immediately must synchronously <a href=#update-the-image-data>update the image data</a> of an <code><a href=#the-img-element>img</a></code> element - whenever that element is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute, + whenever that element is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute + . A user agent that obtains images immediately must also synchronously <a href=#update-the-image-data>update the image data</a> of an <code><a href=#the-img-element>img</a></code> element whenever that element has its <code title=attr-img-src><a href=#attr-img-src>src</a></code>, + or <code title=attr-img-crossorigin><a href=#attr-img-crossorigin>crossorigin</a></code> attribute set, changed, or removed.</p> <!-- Note how this does NOT happen when the base URL changes. --> @@ -23459,6 +23552,7 @@ element's <code title=attr-img-src><a href=#attr-img-src>src</a></code>, + or <code title=attr-img-crossorigin><a href=#attr-img-crossorigin>crossorigin</a></code> attribute set, changed, or removed, if the user agent only obtains images on demand, the <code><a href=#the-img-element>img</a></code> element must return to the <a href=#img-none title=img-none>unavailable</a> state.</p> <!-- Note how this @@ -23558,6 +23652,7 @@ multiple requests when, for example, the <code title=attr-img-src><a href=#attr-img-src>src</a></code>, + and <code title=attr-img-crossorigin><a href=#attr-img-crossorigin>crossorigin</a></code> attributes are all set in succession.</p> @@ -23759,7 +23854,8 @@ 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><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 --><!-- NOTE: the order of these steps is important; it's intended + to make the innermost caption override the outer ones --><li><p>If the image has a <code title=attr-title><a href=#attr-title>title</a></code> attribute whose value is not the empty string, then the value of that attribute is the caption information; abort these steps.</p></li> @@ -23774,6 +23870,8 @@ <code><a href=#the-figcaption-element>figcaption</a></code> element are the caption information; abort these steps.</p></li> + <li><p>There is no caption information.</p></li> + </ol></dd> <dt>If the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute is not @@ -23797,14 +23895,14 @@ </dl><p>The <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute does not represent advisory information. User agents must not present the contents of the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute in - the same way as content of the <code title=attr-title><a href=#the-title-attribute>title</a></code> + the same way as content of the <code title=attr-title><a href=#attr-title>title</a></code> attribute.</p> <p>User agents may always provide the user with the option to display any image, or to prevent any image from being displayed. - <!--POLITICS--><!--FORK--> +<!--POLITICS--><!--FORK--> </p> @@ -23841,7 +23939,7 @@ <div class=impl> <p>The <dfn id=dom-img-alt title=dom-img-alt><code>alt</code></dfn>, <dfn id=dom-img-src title=dom-img-src><code>src</code></dfn>, - + IDL attributes must <a href=#reflect>reflect</a> the respective content attributes of the same name.</p> @@ -23990,7 +24088,7 @@ <p>Here it is not known at the time of publication what the image will be, only that it will be a coat of arms of some kind, and thus no replacement text can be provided, and instead only a brief - caption for the image is provided, in the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute:</p> + caption for the image is provided, in the <code title=attr-title><a href=#attr-title>title</a></code> attribute:</p> <pre><p>The last user to have uploaded a coat of arms uploaded this one:</p> <p><img src="last-uploaded-coat-of-arms.cgi" title="User-uploaded coat of arms."></p></pre> @@ -24077,7 +24175,7 @@ contain text that could be considered the image's <em><a href=#the-caption-element>caption</a></em>, <em><a href=#the-title-element>title</a></em>, or <em><a href=#the-legend-element>legend</a></em>. It is supposed to contain replacement text that could be used by users <em>instead</em> of the - image; it is not meant to supplement the image. The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute can be used for + image; it is not meant to supplement the image. The <code title=attr-title><a href=#attr-title>title</a></code> attribute can be used for supplemental information.</p> <p>Another corollary is that the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute's value should not repeat @@ -24209,7 +24307,7 @@ <p>Text such as "Photo of white house with boarded door" would be equally bad alternative text (though it could be suitable for the - <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute or in the + <code title=attr-title><a href=#attr-title>title</a></code> attribute or in the <code><a href=#the-figcaption-element>figcaption</a></code> element of a <code><a href=#the-figure-element>figure</a></code> with this image).</p> @@ -24394,7 +24492,7 @@ <p>In these cases, it would be wrong to include alternative text that consists of just a caption. If a caption is to be included, - then either the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute can + then either the <code title=attr-title><a href=#attr-title>title</a></code> attribute can be used, or the <code><a href=#the-figure-element>figure</a></code> and <code><a href=#the-figcaption-element>figcaption</a></code> elements can be used. In the latter case, the image would in fact be a phrase or paragraph with an alternative graphical @@ -24476,6 +24574,7 @@ <!--FORK--> + <h6 id=a-group-of-images-that-form-a-single-larger-picture-with-no-links><span class=secno>4.8.1.1.8 </span>A group of images that form a single larger picture with no links</h6> <p>When a picture has been sliced into smaller image files that are @@ -24691,15 +24790,30 @@ be met as well:</p> <ul><!-- when editing this list, search for the two other occurrences - of 'critical-no-alt' --><!--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 + of 'critical-no-alt' --><!-- NOTE: the order of these steps is important; it's intended + to encourage using <figcaption> rather than title="" --><li id=figcaption-as-alt-condition><p>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 <code><a href=#the-figcaption-element>figcaption</a></code> element that contains content other than <a href=#inter-element-whitespace>inter-element whitespace</a>, and, ignoring the <code><a href=#the-figcaption-element>figcaption</a></code> element and its descendants, the <code><a href=#the-figure-element>figure</a></code> element has no <code><a href=#text-0>Text</a></code> node descendants other than <a href=#inter-element-whitespace>inter-element whitespace</a>, and no <a href=#embedded-content-2>embedded content</a> descendant other than the - <code><a href=#the-img-element>img</a></code> element.</li> + <code><a href=#the-img-element>img</a></code> element.</p></li> + + <li> + +<!--FORK--><!--TITLE--> + + <!-- 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 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> </ul><p class=note>Such cases are to be kept to an absolute minimum. If there is even the slightest possibility of the author @@ -24764,7 +24878,7 @@ description is not available, and the user is to provide the description. For instance, the point of a CAPTCHA image is to see if the user can literally read the graphic. Here is one way to - mark up a CAPTCHA (note the <code title=attr-title><a href=#the-title-attribute>title</a></code> + mark up a CAPTCHA (note the <code title=attr-title><a href=#attr-title>title</a></code> attribute):</p> <pre><p><label>What does this image say? @@ -24791,7 +24905,7 @@ </table></pre> <p>Notice that even in this example, as much useful information - as possible is still included in the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute.</p> + as possible is still included in the <code title=attr-title><a href=#attr-title>title</a></code> attribute.</p> </div> @@ -24826,7 +24940,6 @@ - <div class=impl> <h6 id=guidance-for-markup-generators><span class=secno>4.8.1.1.12 </span>Guidance for markup generators</h6> @@ -24870,10 +24983,12 @@ the conditions listed below applies:</p> <ul><!-- when editing this list, search for the two other occurrences - of 'critical-no-alt' --><!--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> + of 'critical-no-alt' --><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 conditions described above</a>.</li> +<!--FORK--><!--TITLE--> + <!-- the following are additional entries not included in the aforementioned list, as they apply only to conformance checkers --> @@ -33963,7 +34078,7 @@ several times). If a <a href=#media-resource>media resource</a>'s audio track exposed in this way has no known name, and it is the only audio track for a particular <a href=#media-element>media element</a>, the user agent - should use the element's <code title=attr-title><a href=#the-title-attribute>title</a></code> + should use the element's <code title=attr-title><a href=#attr-title>title</a></code> attribute, if any, as the name (or as part of the name) of that track.</p> @@ -44915,7 +45030,7 @@ </div> <p>When an <code><a href=#the-input-element>input</a></code> element has a <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code> attribute specified, - authors should include a <code title=attr-title><a href=#the-title-attribute>title</a></code> + authors should include a <code title=attr-title><a href=#attr-title>title</a></code> attribute to give a description of the pattern. User agents may use the contents of this attribute, if it is present, when informing the user that the pattern is not matched, or at any other suitable time, @@ -44933,7 +45048,7 @@ You cannot submit this form when the field is incorrect.</samp></pre> </div> - <p>When a control has a <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code> attribute, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute, if used, must describe + <p>When a control has a <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code> attribute, the <code title=attr-title><a href=#attr-title>title</a></code> attribute, if used, must describe the pattern. Additional information could also be included, so long as it assists the user in filling in the control. Otherwise, assistive technology would be impaired.</p> @@ -44943,9 +45058,9 @@ something like <samp>The text you have entered does not match the required pattern. Birthday</samp>, which is not useful.</p> - <p>UAs may still show the <code title=attr-title><a href=#the-title-attribute>title</a></code> in + <p>UAs may still show the <code title=attr-title><a href=#attr-title>title</a></code> in non-error situations (for example, as a tooltip when hovering over - the control), so authors should be careful not to word <code title=attr-title><a href=#the-title-attribute>title</a></code>s as if an error has necessarily + the control), so authors should be careful not to word <code title=attr-title><a href=#attr-title>title</a></code>s as if an error has necessarily occurred.</p> @@ -45128,7 +45243,7 @@ value or a brief description of the expected format. The attribute, if specified, must have a value that contains no "LF" (U+000A) or "CR" (U+000D) characters.</p> - <p class=note>For a longer hint or other advisory text, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is more appropriate.</p> + <p class=note>For a longer hint or other advisory text, the <code title=attr-title><a href=#attr-title>title</a></code> attribute is more appropriate.</p> <p>The <code title=attr-input-placeholder><a href=#attr-input-placeholder>placeholder</a></code> attribute should not be used as an alternative to a @@ -46828,7 +46943,7 @@ description of the expected format. The attribute, if specified, must have a value that contains no "LF" (U+000A) or "CR" (U+000D) characters.</p> - <p class=note>For a longer hint or other advisory text, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is more appropriate.</p> + <p class=note>For a longer hint or other advisory text, the <code title=attr-title><a href=#attr-title>title</a></code> attribute is more appropriate.</p> <p>The <code title=attr-textarea-placeholder><a href=#attr-textarea-placeholder>placeholder</a></code> attribute should not be used as an alternative to a @@ -47716,7 +47831,7 @@ <p>There is no explicit way to specify units in the <code><a href=#the-meter-element>meter</a></code> element, but the units may be specified in the - <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute in free-form text.</p> + <code title=attr-title><a href=#attr-title>title</a></code> attribute in free-form text.</p> <div class=example> @@ -47903,7 +48018,7 @@ </div> <p>User agents <span class=impl>may</span> combine the value of - the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute and the other + the <code title=attr-title><a href=#attr-title>title</a></code> attribute and the other attributes to provide context-sensitive help or inline text detailing the actual values.</p> @@ -50410,7 +50525,7 @@ <code title=attr-command-checked><a href=#attr-command-checked>checked</a></code>, <code title=attr-command-radiogroup><a href=#attr-command-radiogroup>radiogroup</a></code>, <!--<code title="attr-command-default">default</code>,--> and - <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes defines a new + <code title=attr-title><a href=#attr-title>title</a></code> attributes defines a new command. A <code><a href=#the-command-element>command</a></code> element that uses the <code title=attr-command-command><a href=#attr-command-command>command</a></code> <em>attribute</em> defines a command by reference to another one. This allows authors to define a command once, and set its state (e.g. whether it is @@ -51248,7 +51363,7 @@ attribute.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the value of the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + is the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the element. If the attribute is not present, the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> is the empty string.</p> <p>The <a href=#command-facet-icon title=command-facet-Icon>Icon</a> of the command @@ -51329,7 +51444,7 @@ attribute, if present, is the <a href=#command-facet-label title=command-facet-Label>Label</a>. Otherwise, the <a href=#command-facet-label title=command-facet-Label>Label</a> is the empty string.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the value of the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + is the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the <code><a href=#the-input-element>input</a></code> element. If the attribute is not present, the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> is the empty string.</p> @@ -51394,7 +51509,7 @@ U+0020 SPACE character.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the string given by the element's <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute, if any, and the empty + is the string given by the element's <code title=attr-title><a href=#attr-title>title</a></code> attribute, if any, and the empty string if the attribute is absent.</p> <p>There is no <a href=#command-facet-icon title=command-facet-Icon>Icon</a> for the @@ -51497,9 +51612,9 @@ is the <a href=#command-facet-label title=command-facet-Label>Label</a> of the <a href=#master-command>master command</a>.</p> - <p>If the element has a <code title=attr-title><a href=#the-title-attribute>title</a></code> + <p>If the element has a <code title=attr-title><a href=#attr-title>title</a></code> attribute, then the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of - the command is the value of that <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute. Otherwise, the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command is the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the <a href=#master-command>master + the command is the value of that <code title=attr-title><a href=#attr-title>title</a></code> attribute. Otherwise, the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command is the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the <a href=#master-command>master command</a>.</p> <p>The <a href=#command-facet-icon title=command-facet-Icon>Icon</a> of the command @@ -51549,7 +51664,7 @@ attribute.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the value of the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + is the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the element.</p> <p>There is no <a href=#command-facet-icon title=command-facet-Icon>Icon</a> for the @@ -51590,7 +51705,7 @@ attribute.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the value of the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + is the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the element.</p> <p>There is no <a href=#command-facet-icon title=command-facet-Icon>Icon</a> for the @@ -51640,7 +51755,7 @@ <code><a href=#textcontent>textContent</a></code> of the element itself.</p> <p>The <a href=#command-facet-hint title=command-facet-Hint>Hint</a> of the command - is the value of the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute + is the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute of the element. If the attribute is not present, the <a href=#command-facet-hint title=command-facet-Hint>Hint</a> is the empty string.</p> <p>There is no <a href=#command-facet-icon title=command-facet-Icon>Icon</a> for the @@ -53028,7 +53143,7 @@ <p>If the <code title=rel-alternate><a href=#rel-alternate>alternate</a></code> keyword is also specified on the <code><a href=#the-link-element>link</a></code> element, then <dfn id=the-link-is-an-alternative-stylesheet>the link - is an alternative stylesheet</dfn>; in this case, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute must be specified on the + is an alternative stylesheet</dfn>; in this case, the <code title=attr-title><a href=#attr-title>title</a></code> attribute must be specified on the <code><a href=#the-link-element>link</a></code> element, with a non-empty value.</p> <p>The default type for resources given by the <code title=rel-stylesheet><a href=#link-type-stylesheet>stylesheet</a></code> keyword is <code title="">text/css</code>.</p> @@ -53533,7 +53648,7 @@ <li class="tag-cloud-5"><a title="41 instances" href="/t/pear">pear</a> <span>(very popular)</span> </ul></pre> - <p>The actual frequency of each tag is given using the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute. A CSS style sheet is + <p>The actual frequency of each tag is given using the <code title=attr-title><a href=#attr-title>title</a></code> attribute. A CSS style sheet is provided to convert the markup into a cloud of differently-sized words, but for user agents that do not support CSS or are not visual, the markup contains annotations like "(popular)" or @@ -80422,30 +80537,34 @@ - <h4 id=the-title-attribute-0><span class=secno>10.7.2 </span>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute</h4> + <h4 id=the-title-attribute-0><span class=secno>10.7.2 </span>The <code title=attr-title><a href=#attr-title>title</a></code> attribute</h4> - <p>Given an element (e.g. the element designated by the mouse - cursor), if the element, or one of its ancestors, has a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute, and the nearest such - attribute has a value that is not the empty string, it is expected - that the user agent will expose the contents of that attribute as a - tooltip.</p> + <p>User agents are expected to expose the <a href=#advisory-information>advisory + 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 + user is unable to use a pointing device, then the user agent is + expected to make the content available in some other fashion, e.g. + by making the element focusable and always displaying the + <a href=#advisory-information>advisory information</a> of the currently focused element, + or by showing the <a href=#advisory-information>advisory information</a> of the elements + under the user's finger on a touch device as the user pans around + the screen.</p> <p>"LF" (U+000A) characters are expected to cause line - breaks in the tooltip, "tab" (U+0009) characters + breaks in the tooltip; "tab" (U+0009) characters are expected to render as a non-zero horizontal shift that lines up the next glyph with the next tab stop, with tab stops occurring at points that are multiples of 8 times the width of a U+0020 SPACE character.</p> - <p>User agents are encouraged to make it possible to view tooltips - without the use of a pointing device, since not all users are able - to use pointing devices.</p> - <div class=example> <p>For example, a visual user agent could make elements with a - <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute focusable, and - could make any focused element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute show its tooltip under + <code title=attr-title><a href=#attr-title>title</a></code> attribute focusable, and + could make any focused element with a <code title=attr-title><a href=#attr-title>title</a></code> attribute show its tooltip under the element while the element has focus. This would allow a user to tab around the document to find all the advisory text.</p> @@ -80874,7 +80993,7 @@ instead.</p></dd> <dt><dfn id=attr-tdth-abbr title=attr-tdth-abbr><code>abbr</code></dfn> on <code><a href=#the-td-element>td</a></code> and <code><a href=#the-th-element>th</a></code> elements</dt> - <dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that. The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute can also be useful in including more detailed text, so that the cell's contents can be made terse.</p> + <dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that. The <code title=attr-title><a href=#attr-title>title</a></code> attribute can also be useful in including more detailed text, so that the cell's contents can be made terse.</p> </dd><dt><dfn id=attr-tdth-axis title=attr-tdth-axis><code>axis</code></dfn> on <code><a href=#the-td-element>td</a></code> and <code><a href=#the-th-element>th</a></code> elements</dt> <dd><p>Use the <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code> attribute on the relevant <code><a href=#the-th-element>th</a></code>.</p> @@ -84694,7 +84813,7 @@ </td><td> <a href=#browsing-context>Browsing context</a> for <a href=#form-submission-0>form submission</a> </td><td> <a href=#valid-browsing-context-name-or-keyword>Valid browsing context name or keyword</a> </td></tr><tr><th> <code title="">title</code> - </th><td> <a href=#the-title-attribute title=attr-title>HTML elements</a> + </th><td> <a href=#attr-title title=attr-title>HTML elements</a> </td><td> Advisory information for the element </td><td> <a href=#attribute-text>Text</a> </td></tr><tr><th> <code title="">title</code> Index: obsolete.html =================================================================== RCS file: /sources/public/html5/spec/obsolete.html,v retrieving revision 1.1243 retrieving revision 1.1244 diff -u -d -r1.1243 -r1.1244 --- obsolete.html 21 Sep 2012 00:14:01 -0000 1.1243 +++ obsolete.html 21 Sep 2012 08:14:11 -0000 1.1244 @@ -620,7 +620,7 @@ instead.</p></dd> <dt><dfn id="attr-tdth-abbr" title="attr-tdth-abbr"><code>abbr</code></dfn> on <code><a href="the-td-element.html#the-td-element">td</a></code> and <code><a href="the-th-element.html#the-th-element">th</a></code> elements</dt> - <dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that. The <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute can also be useful in including more detailed text, so that the cell's contents can be made terse.</p> + <dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that. The <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute can also be useful in including more detailed text, so that the cell's contents can be made terse.</p> </dd><dt><dfn id="attr-tdth-axis" title="attr-tdth-axis"><code>axis</code></dfn> on <code><a href="the-td-element.html#the-td-element">td</a></code> and <code><a href="the-th-element.html#the-th-element">th</a></code> elements</dt> <dd><p>Use the <code title="attr-th-scope"><a href="the-th-element.html#attr-th-scope">scope</a></code> attribute on the relevant <code><a href="the-th-element.html#the-th-element">th</a></code>.</p> Index: the-style-element.html =================================================================== RCS file: /sources/public/html5/spec/the-style-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-style-element.html 21 Sep 2012 00:14:08 -0000 1.182 +++ the-style-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -477,12 +477,12 @@ <p id="title-on-style">The <dfn id="attr-style-title" title="attr-style-title"><code>title</code></dfn> attribute on <code><a href="#the-style-element">style</a></code> elements defines <a href="infrastructure.html#alternative-style-sheet-sets">alternative style sheet sets</a>. If the <code><a href="#the-style-element">style</a></code> element has no <code title="attr-style-title"><a href="#attr-style-title">title</a></code> attribute, then it has no - title; the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute of + title; the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute of ancestors does not apply to the <code><a href="#the-style-element">style</a></code> element. <a href="references.html#refsCSSOM">[CSSOM]</a></p> <p class="note">The <code title="attr-style-title"><a href="#attr-style-title">title</a></code> attribute on <code><a href="#the-style-element">style</a></code> elements, like the <code title="attr-link-title"><a href="the-link-element.html#attr-link-title">title</a></code> attribute on <code><a href="the-link-element.html#the-link-element">link</a></code> - elements, differs from the global <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute in that a + elements, differs from the global <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute in that a <code><a href="#the-style-element">style</a></code> block without a title does not inherit the title of the parent element: it merely has no title.</p> Index: introduction.html =================================================================== RCS file: /sources/public/html5/spec/introduction.html,v retrieving revision 1.1245 retrieving revision 1.1246 diff -u -d -r1.1245 -r1.1246 --- introduction.html 21 Sep 2012 00:14:00 -0000 1.1245 +++ introduction.html 21 Sep 2012 08:14:11 -0000 1.1246 @@ -339,6 +339,64 @@ <ol><li><a href="introduction.html#presentational-markup"><span class="secno">1.10.1 </span>Presentational markup</a></li><li><a href="introduction.html#syntax-errors"><span class="secno">1.10.2 </span>Syntax errors</a></li><li><a href="introduction.html#restrictions-on-content-models-and-on-attribute-values"><span class="secno">1.10.3 </span>Restrictions on content models and on attribute values</a></li></ol></li><li><a href="introduction.html#recommended-reading"><span class="secno">1.11 </span>Recommended reading</a></li></ol></li></ol></div> <h2 id="introduction"><span class="secno">1 </span>Introduction</h2> + + <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><a href="the-form-element.html#the-form-element">form</a></code> element's <code title="attr-fs-method"><a href="form-submission.html#attr-fs-method">method</a></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--> + <li>An experimental specification of the legacy <code title="dom-find">window.find()</code> API.</li><!--FIND--> + <li>Some predefined <a href="#mdvocabs">Microdata vocabularies</a>.</li> + <li>The <code>data</code> element for marking up machine-readable data.</li><!--DATA--><!--FORK--> + <li>The <code title="scheme-http+aes">http+aes:</code> and <code title="scheme-http+aes">https+aes:</code> schemes.</li><!--FORK--> + <li>The <a href="offline.html#application-cache">application cache</a> feature's <span title="concept-appcache-mode-prefer-online">prefer-online</span> mode.</li><!--FORK--><!--APPCACHE-PREFER-ONLINE--> + + +<!-- + <p>Features that are part of the WHATWG HTML Living Standard + specification but that are currently published as separate + specifications as well, and are not included in the W3C HTML5 + specification, consist of:</p> + + <ul> + <li><a href="#2dcontext">Canvas 2D Graphics Context</a>--><!--2DCONTEXT--><!-- + <li><a href="#microdata">Microdata</a>--><!--MD--><!-- + <li><a href="#crossDocumentMessages">Cross-document messaging</a> (also known as Communications)--><!--POSTMSG--><!-- + <li><a href="#channel-messaging">Channel messaging</a> (also known as Communications)--><!--POSTMSG--><!-- + </ul> +--> + +<!-- + <h6 class="no-toc">What else is HTML5?</h6> + + <p>Features that are not currently published or maintained by the + WHATWG but that are sometimes considered to be informally part of + "HTML5" include:</p> + + <ul> + <li><a href="http://tools.ietf.org/html/rfc6455">WebSocket protocol</a> + <li><a href="http://tools.ietf.org/html/draft-abarth-mime-sniff">Media Type Sniffing</a> + <li><a href="http://tools.ietf.org/html/rfc6454">The Web Origin Concept</a> + <li><a href="http://dev.w3.org/geo/api/spec-source.html">Geolocation API</a> + <li><a href="http://www.w3.org/TR/SVG/">SVG</a> + <li><a href="http://www.w3.org/TR/MathML/">MathML</a> + <li><a href="http://dev.w3.org/2006/webapi/XMLHttpRequest-2/">XMLHttpRequest</a> + <li>Parts of <a href="http://www.w3.org/Style/CSS/current-work">CSS</a> + <li><a href="http://dev.w3.org/html5/webvtt/">WebVTT</a> + </ul> +--> + +<!-- + <p>The <a href="#forms">forms</a> part of this specification was + previously published separately in a specification known as Web + Forms 2. The <a href="#workers">Web Workers</a> section was also + previously published as a separate document.</p> +--> + +<!-- + <p>See also <a + href="http://wiki.whatwg.org/wiki/FAQ#What_are_the_various_versions_of_the_spec.3F">the + relevant FAQ entry</a>.</p> +--> + <!--VERSION--> Index: the-div-element.html =================================================================== RCS file: /sources/public/html5/spec/the-div-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-div-element.html 21 Sep 2012 00:14:04 -0000 1.182 +++ the-div-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -351,7 +351,7 @@ <pre class="idl">interface <dfn id="htmldivelement">HTMLDivElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {};</pre> </dd> </dl><!--TOPIC:HTML--><p>The <code><a href="#the-div-element">div</a></code> element has no special meaning at all. It - <a href="rendering.html#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="global-attributes.html#classes">class</a></code>, <code title="attr-lang"><a href="global-attributes.html#attr-lang">lang</a></code>, and <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attributes to mark up semantics + <a href="rendering.html#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="global-attributes.html#classes">class</a></code>, <code title="attr-lang"><a href="global-attributes.html#attr-lang">lang</a></code>, and <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attributes to mark up semantics common to a group of consecutive elements.</p> <p class="note">Authors are strongly encouraged to view the Index: common-input-element-attributes.html =================================================================== RCS file: /sources/public/html5/spec/common-input-element-attributes.html,v retrieving revision 1.248 retrieving revision 1.249 diff -u -d -r1.248 -r1.249 --- common-input-element-attributes.html 21 Sep 2012 00:13:58 -0000 1.248 +++ common-input-element-attributes.html 21 Sep 2012 08:14:10 -0000 1.249 @@ -884,7 +884,7 @@ </div> <p>When an <code><a href="the-input-element.html#the-input-element">input</a></code> element has a <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute specified, - authors should include a <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> + authors should include a <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute to give a description of the pattern. User agents may use the contents of this attribute, if it is present, when informing the user that the pattern is not matched, or at any other suitable time, @@ -902,7 +902,7 @@ You cannot submit this form when the field is incorrect.</samp></pre> </div> - <p>When a control has a <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute, the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute, if used, must describe + <p>When a control has a <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute, the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute, if used, must describe the pattern. Additional information could also be included, so long as it assists the user in filling in the control. Otherwise, assistive technology would be impaired.</p> @@ -912,9 +912,9 @@ something like <samp>The text you have entered does not match the required pattern. Birthday</samp>, which is not useful.</p> - <p>UAs may still show the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> in + <p>UAs may still show the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> in non-error situations (for example, as a tooltip when hovering over - the control), so authors should be careful not to word <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code>s as if an error has necessarily + the control), so authors should be careful not to word <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code>s as if an error has necessarily occurred.</p> @@ -1097,7 +1097,7 @@ value or a brief description of the expected format. The attribute, if specified, must have a value that contains no "LF" (U+000A) or "CR" (U+000D) characters.</p> - <p class="note">For a longer hint or other advisory text, the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute is more appropriate.</p> + <p class="note">For a longer hint or other advisory text, the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute is more appropriate.</p> <p>The <code title="attr-input-placeholder"><a href="#attr-input-placeholder">placeholder</a></code> attribute should not be used as an alternative to a Index: the-meter-element.html =================================================================== RCS file: /sources/public/html5/spec/the-meter-element.html,v retrieving revision 1.182 retrieving revision 1.183 diff -u -d -r1.182 -r1.183 --- the-meter-element.html 21 Sep 2012 00:14:06 -0000 1.182 +++ the-meter-element.html 21 Sep 2012 08:14:12 -0000 1.183 @@ -467,7 +467,7 @@ <p>There is no explicit way to specify units in the <code><a href="#the-meter-element">meter</a></code> element, but the units may be specified in the - <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute in free-form text.</p> + <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute in free-form text.</p> <div class="example"> @@ -654,7 +654,7 @@ </div> <p>User agents <span class="impl">may</span> combine the value of - the <code title="attr-title"><a href="global-attributes.html#the-title-attribute">title</a></code> attribute and the other + the <code title="attr-title"><a href="global-attributes.html#attr-title">title</a></code> attribute and the other attributes to provide context-sensitive help or inline text detailing the actual values.</p>
Received on Friday, 21 September 2012 08:14:24 UTC