- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 28 Aug 2008 11:15:50 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27848
Modified Files:
Overview.html
Log Message:
Rename the 'irrelevant' attribute to 'hidden'. (whatwg r2119)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1291
retrieving revision 1.1292
diff -u -d -r1.1291 -r1.1292
--- Overview.html 28 Aug 2008 10:15:11 -0000 1.1291
+++ Overview.html 28 Aug 2008 11:15:47 -0000 1.1292
@@ -1631,8 +1631,8 @@
<li><a href="#editing-intro"><span class=secno>6.1
</span>Introduction</a>
- <li><a href="#the-irrelevant"><span class=secno>6.2 </span>The
- <code>irrelevant</code> attribute</a>
+ <li><a href="#the-hidden"><span class=secno>6.2 </span>The
+ <code>hidden</code> attribute</a>
<li><a href="#activation"><span class=secno>6.3 </span>Activation</a>
@@ -7736,7 +7736,7 @@
readonly attribute <a href="#domstringmap0">DOMStringMap</a> <a href="#dataset" title=dom-dataset>dataset</a>;
// <a href="#user-interaction">user interaction</a>
- attribute boolean <a href="#irrelevant0" title=dom-irrelevant>irrelevant</a>;
+ attribute boolean <a href="#hidden2" title=dom-hidden>hidden</a>;
void <a href="#click1" title=dom-click>click</a>();
void <a href="#scrollintoview" title=dom-scrollIntoView>scrollIntoView</a>();
void <a href="#scrollintoview" title=dom-scrollIntoView>scrollIntoView</a>(in boolean top);
@@ -7825,8 +7825,7 @@
<dd><code title=attr-id><a href="#id">id</a></code>
- <dd><code title=attr-irrelevant><a
- href="#irrelevant">irrelevant</a></code>
+ <dd><code title=attr-hidden><a href="#hidden1">hidden</a></code>
<dd><code title=attr-lang><a href="#lang">lang</a></code>
@@ -17612,7 +17611,7 @@
+ PARAM/null
+ the params, in source order
(WebKit does something different still)
- - the HIDDEN attribute
+ - the HIDDEN attribute (might be moot now)
-->
<dl class=element>
@@ -29605,8 +29604,6 @@
<dd><code title=attr-command-icon><a href="#icon">icon</a></code>
- <dd><code title=attr-command-hidden><a href="#hidden">hidden</a></code>
-
<dd><code title=attr-command-disabled><a
href="#disabled4">disabled</a></code>
@@ -29631,7 +29628,6 @@
attribute DOMString <a href="#type14" 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 boolean <a href="#hidden0" title=dom-command-hidden>hidden</a>;
attribute boolean <a href="#disabled5" title=dom-command-disabled>disabled</a>;
attribute boolean <a href="#checked1" title=dom-command-checked>checked</a>;
attribute DOMString <a href="#radiogroup0" title=dom-command-radiogroup>radiogroup</a>;
@@ -29669,25 +29665,20 @@
specified, the attribute's value must contain a <a href="#valid8">valid
URL</a>.
- <p>The <dfn id=hidden title=attr-command-hidden><code>hidden</code></dfn>
- attribute is a <a href="#boolean0">boolean attribute</a> that, if present,
- indicates that the command is not relevant and is to be hidden.
-
<p>The <dfn id=disabled4
title=attr-command-disabled><code>disabled</code></dfn> attribute is a <a
href="#boolean0">boolean attribute</a> that, if present, indicates that
the command is not available in the current state.
- <p class=note>The distinction between <a href="#disabled7"
- title=command-facet-DisabledState>Disabled State</a> and <a
- href="#hidden1" title=command-facet-HiddenState>Hidden State</a> is
- subtle. A command should be Disabled if, in the same context, it could be
- enabled if only certain aspects of the situation were changed. A command
- should be marked as Hidden if, in that situation, the command will never
- be enabled. For example, in the context menu for a water faucet, the
- command "open" might be Disabled if the faucet is already open, but the
- command "eat" would be marked Hidden since the faucet could never be
- eaten.
+ <p class=note>The distinction between <code title=attr-command-disabled><a
+ href="#disabled4">disabled</a></code> and <code title=attr-hidden><a
+ href="#hidden1">hidden</a></code> is subtle. A command should be disabled
+ if, in the same context, it could be enabled if only certain aspects of
+ the situation were changed. A command should be marked as hidden if, in
+ that situation, the command will never be enabled. For example, in the
+ context menu for a water faucet, the command "open" might be disabled if
+ the faucet is already open, but the command "eat" would be marked hidden
+ since the faucet could never be eaten.
<p>The <dfn id=checked0
title=attr-command-checked><code>checked</code></dfn> attribute is a <a
@@ -29721,8 +29712,7 @@
<p>The <dfn id=type14 title=dom-command-type><code>type</code></dfn>, <dfn
id=label0 title=dom-command-label><code>label</code></dfn>, <dfn id=icon0
- title=dom-command-icon><code>icon</code></dfn>, <dfn id=hidden0
- title=dom-command-hidden><code>hidden</code></dfn>, <dfn id=disabled5
+ title=dom-command-icon><code>icon</code></dfn>, <dfn id=disabled5
title=dom-command-disabled><code>disabled</code></dfn>, <dfn id=checked1
title=dom-command-checked><code>checked</code></dfn>, <dfn id=radiogroup0
title=dom-command-radiogroup><code>radiogroup</code></dfn>, and <dfn
@@ -30203,10 +30193,13 @@
<dt>An element that <a href="#command1" title=concept-command>defines a
command</a>
- <dd>Append the command to the menu. If the element is a <code><a
- href="#command0">command</a></code> element with a <code
- title=attr-command-default><a href="#default2">default</a></code>
- attribute, mark the command as being a default command.</dd>
+ <dd>Append the command to the menu, respecting its <a href="#facets0"
+ title=concept-facet>facets</a><!-- XXX be explicit about what
+ this means for each facet -->.
+ If the element is a <code><a href="#command0">command</a></code> element
+ with a <code title=attr-command-default><a
+ href="#default2">default</a></code> attribute, mark the command as being
+ a default command.</dd>
<!-- XXX if there's an
Icon URL for the command, it should be <span
title="fetch">fetched</span>, and then that image should be
@@ -30370,7 +30363,8 @@
allowing many access points to a single feature to share aspects such as
the disabled state.
- <p id=facets>Commands are defined to have the following <em>facets</em>:
+ <p id=facets>Commands are defined to have the following <dfn id=facets0
+ title=concept-facet>facets</dfn>:
<dl>
<dt><dfn id=type19 title=command-facet-Type>Type</dfn>
@@ -30404,7 +30398,7 @@
<!--
changing base URLs might change the icon -->
- <dt><dfn id=hidden1 title=command-facet-HiddenState>Hidden State</dfn>
+ <dt><dfn id=hidden title=command-facet-HiddenState>Hidden State</dfn>
<dd>Whether the command is hidden or not (basically, whether it should be
shown in menus).
@@ -30412,10 +30406,7 @@
<dt><dfn id=disabled7 title=command-facet-DisabledState>Disabled
State</dfn>
- <dd>Whether the command can be triggered or not. If the <a href="#hidden1"
- title=command-facet-HiddenState>Hidden State</a> is true (hidden) then
- the <a href="#disabled7" title=command-facet-DisabledState>Disabled
- State</a> will be true (disabled) regardless.
+ <dd>Whether the command is relevant and can be triggered or not.
<dt><dfn id=checked2 title=command-facet-CheckedState>Checked State</dfn>
@@ -30453,7 +30444,7 @@
readonly attribute DOMString <a href="#label4" title=dom-command-ro-label>label</a>;
readonly attribute DOMString <a href="#title7" title=dom-command-ro-title>title</a>;
readonly attribute DOMString <a href="#icon2" 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="#hidden0" title=dom-command-ro-hidden>hidden</a>;
readonly attribute boolean <a href="#disabled8" title=dom-command-ro-disabled>disabled</a>;
readonly attribute boolean <a href="#checked3" title=dom-command-ro-checked>checked</a>;
void <a href="#click0" title=dom-command-ro-click>click</a>();
@@ -30513,22 +30504,22 @@
href="#icon0">icon</a></code> DOM attribute on <code><a
href="#command0">command</a></code> elements.
- <p>The <dfn id=hidden2
+ <p>The <dfn id=hidden0
title=dom-command-ro-hidden><code>hidden</code></dfn> attribute must
- return true if the command's <a href="#hidden1"
+ return true if the command's <a href="#hidden"
title=command-facet-HiddenState>Hidden State</a> is that the command is
hidden, and false if it is that the command is not hidden. If the element
does not define a command, the attribute must return false. This attribute
- will be shadowed by the <code title=dom-command-hidden><a
- href="#hidden0">hidden</a></code> DOM attribute on <code><a
- href="#command0">command</a></code> elements.
+ will be shadowed by the <code title=dom-hidden><a
+ href="#hidden2">hidden</a></code> DOM attribute on the <code><a
+ href="#htmlelement">HTMLElement</a></code> interface.
<p>The <dfn id=disabled8
title=dom-command-ro-disabled><code>disabled</code></dfn> attribute must
return true if the command's <a href="#disabled7"
title=command-facet-DisabledState>Disabled State</a> is that the command
is disabled, and false if the command is not disabled. This attribute is
- not affected by the command's <a href="#hidden1"
+ not affected by the command's <a href="#hidden"
title=command-facet-HiddenState>Hidden State</a>. If the element does not
define a command, the attribute must return false. This attribute will be
shadowed by the <code title="">disabled</code> attribute on
@@ -30572,7 +30563,8 @@
href="#using6">button</a></code>, <code title=input-command><a
href="#using7">input</a></code>, <code title=option-command><a
href="#using8">option</a></code>, <code title=command-element><a
- href="#command3">command</a></code>.
+ href="#command3">command</a></code>, <code title=bb-command><a
+ href="#using9">command</a></code>.
<h5 id=using><span class=secno>4.11.6.1. </span><dfn id=using5
title=a-command>Using the <code>a</code> element to define a command</dfn></h5>
@@ -30607,9 +30599,13 @@
Otherwise, there is no <a href="#icon1" title=command-facet-Icon>Icon</a>
for the command.
- <p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a>
- and <a href="#disabled7" title=command-facet-DisabledState>Disabled
- State</a> facets of the command are always false. (The command is always
+ <p>The <a href="#hidden" title=command-facet-HiddenState>Hidden State</a>
+ of the command is true (hidden) if the element has a <code
+ title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
+ false otherwise.
+
+ <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
+ State</a> facet of the command is always false. (The command is always
enabled.)
<p>The <a href="#checked2" title=command-facet-CheckedState>Checked
@@ -30630,7 +30626,7 @@
title=command-facet-ID>ID</a>, <a href="#label3"
title=command-facet-Label>Label</a>, <a href="#hint"
title=command-facet-Hint>Hint</a>, <a href="#icon1"
- title=command-facet-Icon>Icon</a>, <a href="#hidden1"
+ title=command-facet-Icon>Icon</a>, <a href="#hidden"
title=command-facet-HiddenState>Hidden State</a>, <a href="#checked2"
title=command-facet-CheckedState>Checked State</a>, and <a href="#action"
title=command-facet-Action>Action</a> facets of the command are determined
@@ -30695,8 +30691,10 @@
<p>There is no <a href="#icon1" title=command-facet-Icon>Icon</a> for the
command.
- <p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a>
- of the command is always false. (The command is never hidden.)
+ <p>The <a href="#hidden" title=command-facet-HiddenState>Hidden State</a>
+ of the command is true (hidden) if the element has a <code
+ title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
+ false otherwise.
<p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
State</a> of the command mirrors the disabled state of the control.
@@ -30753,8 +30751,10 @@
<p>There is no <a href="#icon1" title=command-facet-Icon>Icon</a> for the
command.
- <p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a>
- of the command is always false. (The command is never hidden.)
+ <p>The <a href="#hidden" title=command-facet-HiddenState>Hidden State</a>
+ of the command is true (hidden) if the element has a <code
+ title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
+ false otherwise.
<p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
State</a> of the command is true (disabled) if the element has a <code
@@ -30814,16 +30814,15 @@
Otherwise, there is no <a href="#icon1" title=command-facet-Icon>Icon</a>
for the command.
- <p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a>
+ <p>The <a href="#hidden" title=command-facet-HiddenState>Hidden State</a>
of the command is true (hidden) if the element has a <code
- title=attr-command-hidden><a href="#hidden">hidden</a></code> attribute,
- and false otherwise.
+ title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
+ false otherwise.
<p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
- State</a> of the command is true (disabled) if the element has either a
- <code title=attr-command-disabled><a href="#disabled4">disabled</a></code>
- attribute or a <code title=attr-command-hidden><a
- href="#hidden">hidden</a></code> attribute (or both), and false otherwise.
+ State</a> of the command is true (disabled) if the element has a <code
+ title=attr-command-disabled><a href="#disabled4">disabled</a></code>
+ attribute, and false otherwise.
<p>The <a href="#checked2" title=command-facet-CheckedState>Checked
State</a> of the command is true (checked) if the element has a <code
@@ -30879,11 +30878,13 @@
href="#bb">bb</a></code> element's <code title=attr-bb-type><a
href="#type15">type</a></code> attribute's state.
- <p>The <a href="#hidden1" title=command-facet-HiddenState>Hidden State</a>
- facet of the command is true if the <code><a href="#bb">bb</a></code>
- element's <code title=attr-bb-type><a href="#type15">type</a></code>
- attribute's state is not <i title=attr-bb-type-null-state><a
- href="#null">null</a></i>.
+ <p>The <a href="#hidden" title=command-facet-HiddenState>Hidden State</a>
+ facet of the command is true (hidden) if the <code><a
+ href="#bb">bb</a></code> element's <code title=attr-bb-type><a
+ href="#type15">type</a></code> attribute's state is <i
+ title=attr-bb-type-null-state><a href="#null">null</a></i> or if the
+ element has a <code title=attr-hidden><a href="#hidden1">hidden</a></code>
+ attribute, and false otherwise.
<p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
State</a> facet of the command is true if the <code><a
@@ -40151,17 +40152,16 @@
<p class=big-issue>Would be nice to explain how these features work
together.
- <h3 id=the-irrelevant><span class=secno>6.2 </span>The <dfn id=irrelevant
- title=attr-irrelevant><code>irrelevant</code></dfn> attribute</h3>
+ <h3 id=the-hidden><span class=secno>6.2 </span>The <dfn id=hidden1
+ title=attr-hidden><code>hidden</code></dfn> attribute</h3>
- <p>All elements may have the <code title=attr-irrelevant><a
- href="#irrelevant">irrelevant</a></code> content attribute set. The <code
- title=attr-irrelevant><a href="#irrelevant">irrelevant</a></code>
- attribute is a <a href="#boolean0">boolean attribute</a>. When specified
- on an element, it indicates that the element is not yet, or is no longer,
- relevant. User agents should not render elements that have the <code
- title=attr-irrelevant><a href="#irrelevant">irrelevant</a></code>
- attribute specified.
+ <p>All elements may have the <code title=attr-hidden><a
+ href="#hidden1">hidden</a></code> content attribute set. The <code
+ title=attr-hidden><a href="#hidden1">hidden</a></code> attribute is a <a
+ href="#boolean0">boolean attribute</a>. When specified on an element, it
+ indicates that the element is not yet, or is no longer, relevant. User
+ agents should not render elements that have the <code title=attr-hidden><a
+ href="#hidden1">hidden</a></code> attribute specified.
<div class=example>
<p>In the following skeletal example, the attribute is used to hide the
@@ -40177,33 +40177,35 @@
<script>
function login() {
// switch screens
- document.getElementById('login').irrelevant = true;
- document.getElementById('game').irrelevant = false;
+ document.getElementById('login').hidden = true;
+ document.getElementById('game').hidden = false;
}
</script>
</section>
- <section id="game" irrelevant>
+ <section id="game" hidden>
...
</section></pre>
</div>
- <p>The <code title=attr-irrelevant><a
- href="#irrelevant">irrelevant</a></code> attribute must not be used to
- hide content that could legitimately be shown in another presentation. For
- example, it is incorrect to use <code title=attr-irrelevant><a
- href="#irrelevant">irrelevant</a></code> to hide panels in a tabbed
- dialog, because the tabbed interface is merely a kind of overflow
+ <p>The <code title=attr-hidden><a href="#hidden1">hidden</a></code>
+ attribute must not be used to hide content that could legitimately be
+ shown in another presentation. For example, it is incorrect to use <code
+ title=attr-hidden><a href="#hidden1">hidden</a></code> to hide panels in a
+ tabbed dialog, because the tabbed interface is merely a kind of overflow
presentation — showing all the form controls in one big page with a
scrollbar would be equivalent, and no less correct.
- <p>Elements in a section hidden by the <code title=attr-irrelevant><a
- href="#irrelevant">irrelevant</a></code> attribute are still active, e.g.
- scripts and form controls in such sections still render execute and submit
- respectively. Only their presentation to the user changes.
+ <p>Elements in a section hidden by the <code title=attr-hidden><a
+ href="#hidden1">hidden</a></code> attribute are still active, e.g. scripts
+ and form controls in such sections still render execute and submit
+ respectively. Only their presentation to the user changes.</p>
+ <!-- XXX might be worth disabling user interaction event submission
+ in hidden areas? e.g. make onmousemove and onclick and form controls
+ not respond to input? -->
- <p>The <dfn id=irrelevant0
- title=dom-irrelevant><code>irrelevant</code></dfn> DOM attribute must <a
- href="#reflect">reflect</a> the content attribute of the same name.
+ <p>The <dfn id=hidden2 title=dom-hidden><code>hidden</code></dfn> DOM
+ attribute must <a href="#reflect">reflect</a> the content attribute of the
+ same name.
<h3 id=activation><span class=secno>6.3 </span>Activation</h3>
Received on Thursday, 28 August 2008 11:16:25 UTC