Skip to content
Permalink
Browse files

rel=icon

git-svn-id: http://svn.whatwg.org/webapps@339 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Nov 22, 2006
1 parent e379ae8 commit 2429192e3053754f61d18d47adf1a6851e8b471a
Showing with 77 additions and 40 deletions.
  1. +61 −40 index
  2. +16 −0 source
101 index
@@ -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
16 source
document provides help for the page as a whole.</p>


<h5>Link type "<dfn title="rel-icon"><code>icon</code></dfn>"</h5>

<p>The <code title="rel-icon">icon</code> keyword may be used with
<code>link</code> elements, for which it creates an <span
title="external resource link">external resource link</span>.</p>

<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>

<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">media</code> attribute.</p>


<h5>Hierarchical link types</h5>

<p>Some documents form part of a hierarchical structure of

0 comments on commit 2429192

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