Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Align the title attribute with implementations #3435

Merged
merged 1 commit into from Jan 31, 2018
Merged

Align the title attribute with implementations #3435

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
49 changes: 20 additions & 29 deletions source
View file
Open in desktop
Expand Up @@ -11550,34 +11550,33 @@ https://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%

<h5>The <code data-x="attr-title">title</code> attribute</h5>

<p>The <dfn><code data-x="attr-title">title</code></dfn> attribute <span>represents</span> advisory
information for the element, such as would be appropriate for a tooltip. On a link, this could be
the title or a description of the target resource; on an image, it could be the image credit or a
description of the image; on a paragraph, it could be a footnote or commentary on the text; on a
citation, it could be further information about the source; on <span>interactive content</span>,
it could be a label for, or instructions for, use of the element; and so forth. The value is
text.</p>
<p>The <dfn><code data-x="attr-title">title</code></dfn> attribute <span>represents</span>
advisory information for the element, such as would be appropriate for a tooltip. On a link, this
could be the title or a description of the target resource; on an image, it could be the image
credit or a description of the image; on a paragraph, it could be a footnote or commentary on the
text; on a citation, it could be further information about the source; on <span>interactive
content</span>, it could be a label for, or instructions for, use of the element; and so forth.
The value is text.</p>

<!-- search for title-warning if modifying this paragraph -->
<p class="note">Relying on the <code data-x="attr-title">title</code> attribute is currently
discouraged as many user agents do not expose the attribute in an accessible manner as required by
this specification (e.g. requiring a pointing device such as a mouse to cause a tooltip to appear,
which excludes keyboard-only users and touch-only users, such as anyone with a modern phone or
tablet).</p>
this specification (e.g., requiring a pointing device such as a mouse to cause a tooltip to
appear, 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
data-x="attr-title">title</code> attribute of the nearest ancestor <span data-x="HTML elements">HTML
element</span> with a <code data-x="attr-title">title</code> attribute set is also relevant to this
element. Setting the attribute overrides this, explicitly stating that the advisory information of
any ancestors is not relevant to this element. Setting the attribute to the empty string indicates
that the element has no advisory information.</p>
data-x="attr-title">title</code> attribute of the nearest ancestor <span data-x="HTML
elements">HTML element</span> with a <code data-x="attr-title">title</code> attribute set is also
relevant to this element. Setting the attribute overrides this, explicitly stating that the
advisory information of any ancestors is not relevant to this element. Setting the attribute to
the empty string indicates that the element has no advisory information.</p>

<p>If the <code data-x="attr-title">title</code> attribute's value contains U+000A LINE FEED (LF)
characters, the content is split into multiple lines. Each U+000A LINE FEED (LF) character
represents a line break.</p>

<div class="example">

<p>Caution is advised with respect to the use of newlines in <code
data-x="attr-title">title</code> attributes.</p>

Expand All @@ -11586,7 +11585,6 @@ https://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%

<pre class="bad">&lt;p>My logs show that there was some interest in &lt;abbr title="Hypertext
Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></pre> <!-- DO NOT REWRAP THIS LINE -->

</div>

<p>Some elements, such as <code>link</code>, <code>abbr</code>, and <code>input</code>, define
Expand All @@ -11600,20 +11598,13 @@ Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></pre> <!-- DO NOT REWRAP THIS L
empty string, then there is no advisory information.</p>

<ol>
<li><p>If the element has a <code data-x="attr-title">title</code> attribute, then return its
value.</p></li>

<li><p>If the element is a <code>link</code>, <code>style</code>, <code>dfn</code>, or
<code>abbr</code> element, then: if the element has a <code data-x="">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 data-x="attr-title">title</code> attribute, then
return its value.</p></li>

<li><p>Otherwise, if the element has a parent element, then return the parent element's
<span>advisory information</span>.</p></li>

<li><p>Otherwise, return the empty string.</p></li>
<li><p>If the element has a parent element, then return the parent element's <span>advisory
information</span>.</p></li>

<li><p>Return the empty string.</p></li>
</ol>

<p>User agents should inform the user when elements have <span>advisory information</span>,
Expand Down