Permalink
Browse files

rel=icon

git-svn-id: http://svn.whatwg.org/webapps@339 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent e379ae8 commit 2429192e3053754f61d18d47adf1a6851e8b471a @Hixie Hixie committed Nov 22, 2006
Showing with 77 additions and 40 deletions.
  1. +61 −40 index
  2. +16 −0 source
View
@@ -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>
@@ -13737,7 +13741,7 @@ XXX selection ranges -->
<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>
@@ -13763,7 +13767,7 @@ XXX selection ranges -->
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>;
@@ -13797,7 +13801,7 @@ XXX selection ranges -->
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.
@@ -13852,7 +13856,7 @@ XXX selection ranges -->
</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
@@ -14940,7 +14944,7 @@ XXX selection ranges -->
<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
@@ -15342,7 +15346,24 @@ XXX selection ranges -->
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.
@@ -15355,7 +15376,7 @@ XXX selection ranges -->
<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
@@ -15374,7 +15395,7 @@ XXX selection ranges -->
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
@@ -15392,7 +15413,7 @@ XXX selection ranges -->
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
@@ -15410,7 +15431,7 @@ XXX selection ranges -->
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
@@ -15424,7 +15445,7 @@ XXX selection ranges -->
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
@@ -15442,7 +15463,7 @@ XXX selection ranges -->
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
@@ -15508,7 +15529,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
-->
- <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.
@@ -16184,7 +16205,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
<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.
@@ -16235,7 +16256,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
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>;
@@ -16287,12 +16308,12 @@ disallow: http://microformats.org/wiki/rel-enclosure
<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
@@ -16381,7 +16402,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
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
@@ -16423,7 +16444,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
<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"
@@ -16486,7 +16507,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
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>
@@ -16543,7 +16564,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
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>
@@ -16599,12 +16620,12 @@ disallow: http://microformats.org/wiki/rel-enclosure
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
View
@@ -13523,6 +13523,22 @@ XXX selection ranges -->
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.