|
|
@@ -708,34 +708,38 @@ |
|
|
<li><a href="#link-type6"><span class=secno>4.5.3.8. </span>Link |
|
|
type "<dfn id=help title=rel-help><code>help</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#hierarchical"><span class=secno>4.5.3.9. |
|
|
<li><a href="#link-type7"><span class=secno>4.5.3.9. </span>Link |
|
|
type "<dfn id=icon title=rel-icon><code>icon</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#hierarchical"><span class=secno>4.5.3.10. |
|
|
</span>Hierarchical link types</a> |
|
|
<ul class=toc> |
|
|
<li><a href="#link-type7"><span class=secno>4.5.3.9.1. </span>Link |
|
|
type "<dfn id=first title=rel-first><code>first</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type8"><span class=secno>4.5.3.10.1. |
|
|
</span>Link type "<dfn id=first |
|
|
title=rel-first><code>first</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type8"><span class=secno>4.5.3.9.2. </span>Link |
|
|
type "<dfn id=index title=rel-index><code>index</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type9"><span class=secno>4.5.3.10.2. |
|
|
</span>Link type "<dfn id=index |
|
|
title=rel-index><code>index</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type9"><span class=secno>4.5.3.9.3. </span>Link |
|
|
type "<dfn id=last title=rel-last><code>last</code></dfn>"</a> |
|
|
<li><a href="#link-type10"><span class=secno>4.5.3.10.3. |
|
|
</span>Link type "<dfn id=last |
|
|
title=rel-last><code>last</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type10"><span class=secno>4.5.3.9.4. |
|
|
<li><a href="#link-type11"><span class=secno>4.5.3.10.4. |
|
|
</span>Link type "<dfn id=next |
|
|
title=rel-next><code>next</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type11"><span class=secno>4.5.3.9.5. |
|
|
<li><a href="#link-type12"><span class=secno>4.5.3.10.5. |
|
|
</span>Link type "<dfn id=prev |
|
|
title=rel-prev><code>prev</code></dfn>"</a> |
|
|
|
|
|
<li><a href="#link-type12"><span class=secno>4.5.3.9.6. |
|
|
<li><a href="#link-type13"><span class=secno>4.5.3.10.6. |
|
|
</span>Link type "<dfn id=up |
|
|
title=rel-up><code>up</code></dfn>"</a> |
|
|
</ul> |
|
|
|
|
|
<li><a href="#other"><span class=secno>4.5.3.10. </span>Other link |
|
|
<li><a href="#other"><span class=secno>4.5.3.11. </span>Other link |
|
|
types</a> |
|
|
</ul> |
|
|
|
|
|
|
|
|
|
|
|
<dd><code title=attr-command-label><a href="#label">label</a></code> |
|
|
|
|
|
<dd><code title=attr-command-icon><a href="#icon">icon</a></code> |
|
|
<dd><code title=attr-command-icon><a href="#icon0">icon</a></code> |
|
|
|
|
|
<dd><code title=attr-command-hidden><a href="#hidden">hidden</a></code> |
|
|
|
|
|
|
|
|
class=idl>interface <dfn id=htmlcommandelement>HTMLCommandElement</dfn> : <a href="#htmlelement">HTMLElement</a> { |
|
|
attribute DOMString <a href="#type12" title=dom-command-type>type</a>; |
|
|
attribute DOMString <a href="#label0" title=dom-command-label>label</a>; |
|
|
attribute DOMString <a href="#icon0" title=dom-command-icon>icon</a>; |
|
|
attribute DOMString <a href="#icon1" title=dom-command-icon>icon</a>; |
|
|
attribute boolean <a href="#hidden0" title=dom-command-hidden>hidden</a>; |
|
|
attribute boolean <a href="#disabled4" title=dom-command-disabled>disabled</a>; |
|
|
attribute boolean <a href="#checked1" title=dom-command-checked>checked</a>; |
|
|
|
|
|
attribute gives a hint describing the command, which might be shown to the |
|
|
user to help him. |
|
|
|
|
|
<p>The <dfn id=icon title=attr-command-icon><code>icon</code></dfn> |
|
|
<p>The <dfn id=icon0 title=attr-command-icon><code>icon</code></dfn> |
|
|
attribute gives a picture that represents the command. If the attribute is |
|
|
specified, the attribute's value must contain a URI. |
|
|
|
|
|
|
|
|
</div> |
|
|
|
|
|
<p>The <dfn id=type12 title=dom-command-type><code>type</code></dfn>, <dfn |
|
|
id=label0 title=dom-command-label><code>label</code></dfn>, <dfn id=icon0 |
|
|
id=label0 title=dom-command-label><code>label</code></dfn>, <dfn id=icon1 |
|
|
title=dom-command-icon><code>icon</code></dfn>, <dfn id=hidden0 |
|
|
title=dom-command-hidden><code>hidden</code></dfn>, <dfn id=disabled4 |
|
|
title=dom-command-disabled><code>disabled</code></dfn>, <dfn id=checked1 |
|
|
|
|
|
<td>Provides a link to context-sensitive help. |
|
|
|
|
|
<tr> |
|
|
<td><code title=rel-icon>icon</code></td> |
|
|
<td><code title=rel-icon><a href="#icon2">icon</a></code></td> |
|
|
<!-- link rel="shortcut icon" and its ilk are the fourth, sixth, and ninth most used values --> |
|
|
|
|
|
<td><a href="#links1" title="external resource link">External |
|
|
|
|
|
title=rel-help><a href="#help0">help</a></code> keyword indicates that the |
|
|
referenced document provides help for the page as a whole. |
|
|
|
|
|
<h5 id=hierarchical><span class=secno>4.5.3.9. </span>Hierarchical link |
|
|
<h5 id=link-type7><span class=secno>4.5.3.9. </span>Link type "<dfn |
|
|
id=icon2 title=rel-icon><code>icon</code></dfn>"</h5> |
|
|
|
|
|
<p>The <code title=rel-icon><a href="#icon2">icon</a></code> keyword may be |
|
|
used with <code><a href="#link0">link</a></code> elements, for which it |
|
|
creates an <a href="#links1" title="external resource link">external |
|
|
resource link</a>. |
|
|
|
|
|
<p>The specified resource is an icon representing the page or site, and |
|
|
should be used by the user agent when representing the page in the user |
|
|
interface. |
|
|
|
|
|
<p>Icons could be aural icons, visual icons, or other kinds of icons. If |
|
|
multiple icons are provided, the user agent must select the most |
|
|
appropriate icon according to the <code title=attr-link-media><a |
|
|
href="#media">media</a></code> attribute. |
|
|
|
|
|
<h5 id=hierarchical><span class=secno>4.5.3.10. </span>Hierarchical link |
|
|
types</h5> |
|
|
|
|
|
<p>Some documents form part of a hierarchical structure of documents. |
|
|
|
|
|
<em>previous sibling</em>, and the one that follows it is its <em>next |
|
|
sibling</em>. A document with no parent forms the top of the hierarchy. |
|
|
|
|
|
<h6 id=link-type7><span class=secno>4.5.3.9.1. </span>Link type "<dfn |
|
|
<h6 id=link-type8><span class=secno>4.5.3.10.1. </span>Link type "<dfn |
|
|
id=first0 title=rel-first><code>first</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-first><a href="#first0">first</a></code> keyword may |
|
|
|
|
|
title="">start</code>" like the <code title=rel-first><a |
|
|
href="#first0">first</a></code> keyword. |
|
|
|
|
|
<h6 id=link-type8><span class=secno>4.5.3.9.2. </span>Link type "<dfn |
|
|
<h6 id=link-type9><span class=secno>4.5.3.10.2. </span>Link type "<dfn |
|
|
id=index0 title=rel-index><code>index</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-index><a href="#index0">index</a></code> keyword may |
|
|
|
|
|
title="">contents</code>", and "<code title="">toc</code>" like the <code |
|
|
title=rel-index><a href="#index0">index</a></code> keyword. |
|
|
|
|
|
<h6 id=link-type9><span class=secno>4.5.3.9.3. </span>Link type "<dfn |
|
|
<h6 id=link-type10><span class=secno>4.5.3.10.3. </span>Link type "<dfn |
|
|
id=last0 title=rel-last><code>last</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-last><a href="#last0">last</a></code> keyword may be |
|
|
|
|
|
treat the keyword "<code title="">end</code>" like the <code |
|
|
title=rel-last><a href="#last0">last</a></code> keyword. |
|
|
|
|
|
<h6 id=link-type10><span class=secno>4.5.3.9.4. </span>Link type "<dfn |
|
|
<h6 id=link-type11><span class=secno>4.5.3.10.4. </span>Link type "<dfn |
|
|
id=next0 title=rel-next><code>next</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-next><a href="#next0">next</a></code> keyword may be |
|
|
|
|
|
the link is leading to the document that is the next sibling of the |
|
|
current document. |
|
|
|
|
|
<h6 id=link-type11><span class=secno>4.5.3.9.5. </span>Link type "<dfn |
|
|
<h6 id=link-type12><span class=secno>4.5.3.10.5. </span>Link type "<dfn |
|
|
id=prev0 title=rel-prev><code>prev</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-prev><a href="#prev0">prev</a></code> keyword may be |
|
|
|
|
|
treat the keyword "<code title="">previous</code>" like the <code |
|
|
title=rel-prev><a href="#prev0">prev</a></code> keyword. |
|
|
|
|
|
<h6 id=link-type12><span class=secno>4.5.3.9.6. </span>Link type "<dfn |
|
|
<h6 id=link-type13><span class=secno>4.5.3.10.6. </span>Link type "<dfn |
|
|
id=up0 title=rel-up><code>up</code></dfn>"</h6> |
|
|
|
|
|
<p>The <code title=rel-up><a href="#up0">up</a></code> keyword may be used |
|
|
|
|
|
|
|
|
--> |
|
|
|
|
|
<h5 id=other><span class=secno>4.5.3.10. </span>Other link types</h5> |
|
|
<h5 id=other><span class=secno>4.5.3.11. </span>Other link types</h5> |
|
|
|
|
|
<p class=big-issue>Address extensibility. |
|
|
|
|
|
|
|
|
|
|
|
<dd>A helpful or descriptive string that can be shown to the user. |
|
|
|
|
|
<dt><dfn id=icon1 title=command-facet-Icon>Icon</dfn> |
|
|
<dt><dfn id=icon3 title=command-facet-Icon>Icon</dfn> |
|
|
|
|
|
<dd>A graphical image that represents the action. |
|
|
|
|
|
|
|
|
readonly attribute DOMString <a href="#id2" title=dom-command-ro-id>id</a>; |
|
|
readonly attribute DOMString <a href="#label3" title=dom-command-ro-label>label</a>; |
|
|
readonly attribute DOMString <a href="#title8" title=dom-command-ro-title>title</a>; |
|
|
readonly attribute DOMString <a href="#icon2" title=dom-command-ro-icon>icon</a>; |
|
|
readonly attribute DOMString <a href="#icon4" title=dom-command-ro-icon>icon</a>; |
|
|
readonly attribute boolean <a href="#hidden2" title=dom-command-ro-hidden>hidden</a>; |
|
|
readonly attribute boolean <a href="#disabled6" title=dom-command-ro-disabled>disabled</a>; |
|
|
readonly attribute boolean <a href="#checked3" title=dom-command-ro-checked>checked</a>; |
|
|
|
|
|
<code title=dom-title><a href="#title1">title</a></code> DOM attribute on |
|
|
the <code><a href="#htmlelement">HTMLElement</a></code> interface. |
|
|
|
|
|
<p>The <dfn id=icon2 title=dom-command-ro-icon><code>icon</code></dfn> |
|
|
attribute must return an absolute URI to the command's <a href="#icon1" |
|
|
<p>The <dfn id=icon4 title=dom-command-ro-icon><code>icon</code></dfn> |
|
|
attribute must return an absolute URI to the command's <a href="#icon3" |
|
|
title=command-facet-Icon>Icon</a>. If the element does not specify an |
|
|
icon, or if the element does not define a command, then the attribute must |
|
|
return null. This attribute will be shadowed by the <code |
|
|
title=dom-command-icon><a href="#icon0">icon</a></code> DOM attribute on |
|
|
title=dom-command-icon><a href="#icon1">icon</a></code> DOM attribute on |
|
|
<code><a href="#command1">command</a></code> elements. |
|
|
|
|
|
<p>The <dfn id=hidden2 |
|
|
|
|
|
attribute is not present, the <a href="#hint" |
|
|
title=command-facet-Hint>Hint</a> is the empty string. |
|
|
|
|
|
<p>The <a href="#icon1" title=command-facet-Icon>Icon</a> of the command is |
|
|
<p>The <a href="#icon3" title=command-facet-Icon>Icon</a> of the command is |
|
|
the absolute URI of the first image in the element. Specifically, in a |
|
|
depth-first search of the children of the element, the first element that |
|
|
is <!--either an--> <code><a href="#img0">img</a></code> element with a |
|
|
|
|
|
<p>The <a href="#type15" title=command-facet-Type>Type</a>, <a href="#id1" |
|
|
title=command-facet-ID>ID</a>, <a href="#label2" |
|
|
title=command-facet-Label>Label</a>, <a href="#hint" |
|
|
title=command-facet-Hint>Hint</a>, <a href="#icon1" |
|
|
title=command-facet-Hint>Hint</a>, <a href="#icon3" |
|
|
title=command-facet-Icon>Icon</a>, <a href="#hidden1" |
|
|
title=command-facet-HiddenState>Hidden State</a>, <a href="#checked2" |
|
|
title=command-facet-CheckedState>Checked State</a>, and <a href="#action" |
|
|
|
|
|
present, the <a href="#hint" title=command-facet-Hint>Hint</a> is the |
|
|
empty string. |
|
|
|
|
|
<p>There is no <a href="#icon1" title=command-facet-Icon>Icon</a> for the |
|
|
<p>There is no <a href="#icon3" title=command-facet-Icon>Icon</a> for the |
|
|
command. |
|
|
|
|
|
<p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a> |
|
|
|
|
|
href="#title0">title</a></code> attribute, if any, and the empty string if |
|
|
the attribute is absent. |
|
|
|
|
|
<p>There is no <a href="#icon1" title=command-facet-Icon>Icon</a> for the |
|
|
<p>There is no <a href="#icon3" title=command-facet-Icon>Icon</a> for the |
|
|
command. |
|
|
|
|
|
<p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a> |
|
|
|
|
|
href="#title7">title</a></code> attribute, if any, and the empty string if |
|
|
the attribute is absent. |
|
|
|
|
|
<p>The <a href="#icon1" title=command-facet-Icon>Icon</a> for the command |
|
|
<p>The <a href="#icon3" title=command-facet-Icon>Icon</a> for the command |
|
|
is the absolute URI resulting from resolving the value of the element's |
|
|
<code title=attr-command-icon><a href="#icon">icon</a></code> attribute as |
|
|
a URI relative to the element's base URI. If the element has no <code |
|
|
title=attr-command-icon><a href="#icon">icon</a></code> attribute then the |
|
|
command has no <a href="#icon1" title=command-facet-Icon>Icon</a>. |
|
|
<code title=attr-command-icon><a href="#icon0">icon</a></code> attribute |
|
|
as a URI relative to the element's base URI. If the element has no <code |
|
|
title=attr-command-icon><a href="#icon0">icon</a></code> attribute then |
|
|
the command has no <a href="#icon3" title=command-facet-Icon>Icon</a>. |
|
|
|
|
|
<p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a> |
|
|
of the command is true (hidden) if the element has a <code |
