[html5] r1079 - /
whatwg at whatwg.org
whatwg at whatwg.org
Fri Oct 19 11:52:48 PDT 2007
Author: ianh
Date: 2007-10-19 11:52:47 -0700 (Fri, 19 Oct 2007)
New Revision: 1079
Modified:
index
source
Log:
[e] (0) Moving <meter> around.
Modified: index
===================================================================
--- index 2007-10-19 04:48:05 UTC (rev 1078)
+++ index 2007-10-19 18:52:47 UTC (rev 1079)
@@ -530,12 +530,12 @@
<li><a href="#the-time"><span class=secno>3.12.10. </span>The
<code>time</code> element</a>
- <li><a href="#the-meter"><span class=secno>3.12.11. </span>The
+ <li><a href="#the-progress"><span class=secno>3.12.11. </span>The
+ <code>progress</code> element</a>
+
+ <li><a href="#the-meter"><span class=secno>3.12.12. </span>The
<code>meter</code> element</a>
- <li><a href="#the-progress"><span class=secno>3.12.12. </span>The
- <code>progress</code> element</a>
-
<li><a href="#the-code"><span class=secno>3.12.13. </span>The
<code>code</code> element</a>
@@ -10797,8 +10797,194 @@
for marking event dates in hCalendar markup. Thus the DOM APIs are likely
to be used as ways to generate interactive calendar widgets or some such.
- <h4 id=the-meter><span class=secno>3.12.11. </span>The <dfn
+ <h4 id=the-progress><span class=secno>3.12.11. </span>The <dfn
+ id=progress><code>progress</code></dfn> element</h4>
+
+ <p><a href="#strictly">Strictly inline-level content</a>.
+
+ <dl class=element>
+ <dt>Contexts in which this element may be used:
+
+ <dd>Where <a href="#strictly">strictly inline-level content</a> is
+ allowed.
+
+ <dt>Content model:
+
+ <dd><a href="#strictly">Strictly inline-level content</a>.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-progress-value><a href="#value1">value</a></code>
+
+ <dd><code title=attr-progress-max><a href="#max">max</a></code>
+
+ <dt>DOM interface:
+
+ <dd>
+ <pre
+ class=idl>interface <dfn id=htmlprogresselement>HTMLProgressElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute float <a href="#value2" title=dom-progress-value>value</a>;
+ attribute float <a href="#max0" title=dom-progress-max>max</a>;
+ readonly attribute float <a href="#position" title=dom-progress-position>position</a>;
+};</pre>
+ </dl>
+
+ <p>The <code><a href="#progress">progress</a></code> element represents the
+ completion progress of a task. The progress is either indeterminate,
+ indicating that progress is being made but that it is not clear how much
+ more work remains to be done before the task is complete (e.g. because the
+ task is waiting for a remote host to respond), or the progress is a number
+ in the range zero to a maximum, giving the fraction of work that has so
+ far been completed.
+
+ <p>There are two attributes that determine the current task completion
+ represented by the element.
+
+ <p>The <dfn id=value1 title=attr-progress-value><code>value</code></dfn>
+ attribute specifies how much of the task has been completed, and the <dfn
+ id=max title=attr-progress-max><code>max</code></dfn> attribute specifies
+ how much work the task requires in total. The units are arbitrary and not
+ specified.
+
+ <p>Instead of using the attributes, authors are recommended to simply
+ include the current value and the maximum value inline as text inside the
+ element.
+
+ <div class=example>
+ <p>Here is a snippet of a Web application that shows the progress of some
+ automated task:</p>
+
+ <pre><section>
+ <h2>Task Progress</h2>
+ <p><label>Progress: <progress><span id="p">0</span>%</progress></p>
+ <script>
+ var progressBar = document.getElementById('p');
+ function updateProgress(newValue) {
+ progressBar.textContent = newValue;
+ }
+ </script>
+</section></pre>
+
+ <p>(The <code>updateProgress()</code> method in this example would be
+ called by some other code on the page to update the actual progress bar
+ as the task progressed.)</p>
+ </div>
+
+ <p><strong>Author requirements</strong>: The <code
+ title=attr-progress-max><a href="#max">max</a></code> and <code
+ title=attr-progress-value><a href="#value1">value</a></code> attributes,
+ when present, must have values that are <a href="#valid1" title="valid
+ floating point number">valid floating point numbers</a>. The <code
+ title=attr-progress-max><a href="#max">max</a></code> attribute, if
+ present, must have a value greater than zero. The <code
+ title=attr-progress-value><a href="#value1">value</a></code> attribute, if
+ present, must have a value equal to or greater than zero, and less than or
+ equal to the value of the <code title=attr-progress-max><a
+ href="#max">max</a></code> attribute, if present.
+
+ <p><strong>User agent requirements</strong>: User agents must parse the
+ <code title=attr-progress-max><a href="#max">max</a></code> and <code
+ title=attr-progress-value><a href="#value1">value</a></code> attributes'
+ values according to the <a href="#rules1">rules for parsing floating point
+ number values</a>.
+
+ <p>If the <code title=attr-progress-value><a
+ href="#value1">value</a></code> attribute is omitted, then user agents
+ must also parse the <code><a href="#textcontent">textContent</a></code> of
+ the <code><a href="#progress">progress</a></code> element in question
+ using the <a href="#steps">steps for finding one or two numbers of a ratio
+ in a string</a>. These steps will return nothing, one number, one number
+ with a denominator punctuation character, or two numbers.
+
+ <p>Using the results of this processing, user agents must determine whether
+ the progress bar is an indeterminate progress bar, or whether it is a
+ determinate progress bar, and in the latter case, what its current and
+ maximum values are, all as follows:
+
+ <ol>
+ <li>If the <code title=attr-progress-max><a href="#max">max</a></code>
+ attribute is omitted, and the <code title=attr-progress-value><a
+ href="#value1">value</a></code> is omitted, and the results of parsing
+ the <code><a href="#textcontent">textContent</a></code> was nothing, then
+ the progress bar is an indeterminate progress bar. Abort these steps.
+
+ <li>Otherwise, it is a determinate progress bar.
+
+ <li>If the <code title=attr-progress-max><a href="#max">max</a></code>
+ attribute is included, then, if a value could be parsed out of it, then
+ the maximum value is that value.
+
+ <li>Otherwise, if the <code title=attr-progress-max><a
+ href="#max">max</a></code> attribute is absent but the <code
+ title=attr-progress-value><a href="#value1">value</a></code> attribute is
+ present, or, if the <code title=attr-progress-max><a
+ href="#max">max</a></code> attribute is present but no value could be
+ parsed from it, then the maximum is 1.
+
+ <li>Otherwise, if neither attribute is included, then, if the <code><a
+ href="#textcontent">textContent</a></code> contained one number with an
+ associated denominator punctuation character, then the maximum value is
+ the <span>value associated with that denominator punctuation
+ character</span>; otherwise, if the <code><a
+ href="#textcontent">textContent</a></code> contained two numbers, the
+ maximum value is the higher of the two values; otherwise, the maximum
+ value is 1.
+
+ <li>If the <code title=attr-progress-value><a
+ href="#value1">value</a></code> attribute is present on the element and a
+ value could be parsed out of it, that value is the current value of the
+ progress bar. Otherwise, if the attribute is present but no value could
+ be parsed from it, the current value is zero.
+
+ <li>Otherwise if the <code title=attr-progress-value><a
+ href="#value1">value</a></code> attribute is absent and the <code
+ title=attr-progress-max><a href="#max">max</a></code> attribute is
+ present, then, if the <code><a href="#textcontent">textContent</a></code>
+ was parsed and found to contain just one number, with no associated
+ denominator punctuation character, then the current value is that number.
+ Otherwise, if the <code title=attr-progress-value><a
+ href="#value1">value</a></code> attribute is absent and the <code
+ title=attr-progress-max><a href="#max">max</a></code> attribute is
+ present then the current value is zero.
+
+ <li>Otherwise, if neither attribute is present, then the current value is
+ the lower of the one or two numbers that were found in the <code><a
+ href="#textcontent">textContent</a></code> of the element.
+
+ <li>If the maximum value is less than or equal to zero, then it is reset
+ to 1.
+
+ <li>If the current value is less than zero, then it is reset to zero.
+
+ <li>Finally, if the current value is greater than the maximum value, then
+ the current value is reset to the maximum value.
+ </ol>
+
+ <p><strong>UA requirements for showing the progress bar</strong>: When
+ representing a <code><a href="#progress">progress</a></code> element to
+ the user, the UA should indicate whether it is a determinate or
+ indeterminate progress bar, and in the former case, should indicate the
+ relative position of the current value relative to the maximum value.
+
+ <p>The <dfn id=max0 title=dom-progress-max><code>max</code></dfn> and <dfn
+ id=value2 title=dom-progress-value><code>value</code></dfn> DOM attributes
+ must reflect the elements' content attributes of the same name. When the
+ relevant content attributes are absent, the DOM attributes must return
+ zero. The value parsed from the <code><a
+ href="#textcontent">textContent</a></code> never affects the DOM values.
+
+ <p class=big-issue>Would be cool to have the <code
+ title=dom-progress-value><a href="#value2">value</a></code> DOM attribute
+ update the <code><a href="#textcontent">textContent</a></code> in-line...
+
+ <p>If the progress bar is an indeterminate progress bar, then the <dfn
+ id=position title=dom-progress-position><code>position</code></dfn> DOM
+ attribute must return -1. Otherwise, it must return the result of dividing
+ the current value by the maximum value.
+
+ <h4 id=the-meter><span class=secno>3.12.12. </span>The <dfn
id=meter><code>meter</code></dfn> element</h4>
+ <!-- Keep this after <progress> and NOT close to <time> -->
<p><a href="#strictly">Strictly inline-level content</a>.
@@ -10814,7 +11000,7 @@
<dt>Element-specific attributes:
- <dd><code title=attr-meter-value><a href="#value1">value</a></code>
+ <dd><code title=attr-meter-value><a href="#value3">value</a></code>
<dd><code title=attr-meter-min><a href="#min">min</a></code>
@@ -10822,7 +11008,7 @@
<dd><code title=attr-meter-high><a href="#high">high</a></code>
- <dd><code title=attr-meter-max><a href="#max">max</a></code>
+ <dd><code title=attr-meter-max><a href="#max1">max</a></code>
<dd><code title=attr-meter-optimum><a href="#optimum">optimum</a></code>
@@ -10831,9 +11017,9 @@
<dd>
<pre
class=idl>interface <dfn id=htmlmeterelement>HTMLMeterElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute long <a href="#value2" title=dom-meter-value>value</a>;
+ attribute long <a href="#value4" title=dom-meter-value>value</a>;
attribute long <a href="#min0" title=dom-meter-min>min</a>;
- attribute long <a href="#max0" title=dom-meter-max>max</a>;
+ attribute long <a href="#max2" title=dom-meter-max>max</a>;
attribute long <a href="#low0" title=dom-meter-low>low</a>;
attribute long <a href="#high0" title=dom-meter-high>high</a>;
attribute long <a href="#optimum0" title=dom-meter-optimum>optimum</a>;
@@ -10856,9 +11042,9 @@
represented by the element.
<p>The <dfn id=min title=attr-meter-min><code>min</code></dfn> attribute
- specifies the lower bound of the range, and the <dfn id=max
+ specifies the lower bound of the range, and the <dfn id=max1
title=attr-meter-max><code>max</code></dfn> attribute specifies the upper
- bound. The <dfn id=value1 title=attr-meter-value><code>value</code></dfn>
+ bound. The <dfn id=value3 title=attr-meter-value><code>value</code></dfn>
attribute specifies the value to have the gauge indicate as the "measured"
value.
@@ -10882,11 +11068,11 @@
current value), or as a percentage or similar (using one of the characters
such as "%"), or as a fraction.
- <p>The <code title=attr-meter-value><a href="#value1">value</a></code>,
+ <p>The <code title=attr-meter-value><a href="#value3">value</a></code>,
<code title=attr-meter-min><a href="#min">min</a></code>, <code
title=attr-meter-low><a href="#low">low</a></code>, <code
title=attr-meter-high><a href="#high">high</a></code>, <code
- title=attr-meter-max><a href="#max">max</a></code>, and <code
+ title=attr-meter-max><a href="#max1">max</a></code>, and <code
title=attr-meter-optimum><a href="#optimum">optimum</a></code> attributes
are all optional. When present, they must have values that are <a
href="#valid1" title="valid floating point number">valid floating point
@@ -10907,15 +11093,15 @@
<p><strong>User agent requirements</strong>: User agents must parse the
<code title=attr-meter-min><a href="#min">min</a></code>, <code
- title=attr-meter-max><a href="#max">max</a></code>, <code
- title=attr-meter-value><a href="#value1">value</a></code>, <code
+ title=attr-meter-max><a href="#max1">max</a></code>, <code
+ title=attr-meter-value><a href="#value3">value</a></code>, <code
title=attr-meter-low><a href="#low">low</a></code>, <code
title=attr-meter-high><a href="#high">high</a></code>, and <code
title=attr-meter-optimum><a href="#optimum">optimum</a></code> attributes
using the <a href="#rules1">rules for parsing floating point number
values</a>.
- <p>If the <code title=attr-meter-value><a href="#value1">value</a></code>
+ <p>If the <code title=attr-meter-value><a href="#value3">value</a></code>
attribute has been omitted, the user agent must also process the <code><a
href="#textcontent">textContent</a></code> of the element according to the
<a href="#steps">steps for finding one or two numbers of a ratio in a
@@ -10937,21 +11123,21 @@
<dt>The maximum value
<dd>
- <p>If the <code title=attr-meter-max><a href="#max">max</a></code>
+ <p>If the <code title=attr-meter-max><a href="#max1">max</a></code>
attribute is specified and a value could be parsed out of it, the
maximum value is that value.</p>
<p>Otherwise, if the <code title=attr-meter-max><a
- href="#max">max</a></code> attribute is specified but no value could be
+ href="#max1">max</a></code> attribute is specified but no value could be
parsed out of it, or if it was not specified, but either or both of the
<code title=attr-meter-min><a href="#min">min</a></code> or <code
- title=attr-meter-value><a href="#value1">value</a></code> attributes
+ title=attr-meter-value><a href="#value3">value</a></code> attributes
<em>were</em> specified, then the maximum value is 1.</p>
<p>Otherwise, none of the <code title=attr-meter-max><a
- href="#max">max</a></code>, <code title=attr-meter-min><a
+ href="#max1">max</a></code>, <code title=attr-meter-min><a
href="#min">min</a></code>, and <code title=attr-meter-value><a
- href="#value1">value</a></code> attributes were specified. If the result
+ href="#value3">value</a></code> attributes were specified. If the result
of processing the <code><a href="#textcontent">textContent</a></code> of
the element was either nothing or just one number with no denominator
punctuation character, then the maximum value is 1; if the result was
@@ -10970,27 +11156,27 @@
<dt>The actual value
<dd>
- <p>If the <code title=attr-meter-value><a href="#value1">value</a></code>
+ <p>If the <code title=attr-meter-value><a href="#value3">value</a></code>
attribute is specified and a value could be parsed out of it, then that
value is the actual value.</p>
- <p>If the <code title=attr-meter-value><a href="#value1">value</a></code>
+ <p>If the <code title=attr-meter-value><a href="#value3">value</a></code>
attribute is not specified but the <code title=attr-meter-max><a
- href="#max">max</a></code> attribute <em>is</em> specified and the
+ href="#max1">max</a></code> attribute <em>is</em> specified and the
result of processing the <code><a
href="#textcontent">textContent</a></code> of the element was one number
with no associated denominator punctuation character, then that number
is the actual value.</p>
<p>If neither of the <code title=attr-meter-value><a
- href="#value1">value</a></code> and <code title=attr-meter-max><a
- href="#max">max</a></code> attributes are specified, then, if the result
- of processing the <code><a href="#textcontent">textContent</a></code> of
- the element was one number (with or without an associated denominator
- punctuation character), then that is the actual value, and if the result
- of processing the <code><a href="#textcontent">textContent</a></code> of
- the element was two numbers, then the actual value is the lower of the
- two numbers found.</p>
+ href="#value3">value</a></code> and <code title=attr-meter-max><a
+ href="#max1">max</a></code> attributes are specified, then, if the
+ result of processing the <code><a
+ href="#textcontent">textContent</a></code> of the element was one number
+ (with or without an associated denominator punctuation character), then
+ that is the actual value, and if the result of processing the <code><a
+ href="#textcontent">textContent</a></code> of the element was two
+ numbers, then the actual value is the lower of the two numbers found.</p>
<p>Otherwise, if none of the above apply, the actual value is zero.</p>
@@ -11107,7 +11293,7 @@
</div>
<p>The <dfn id=min0 title=dom-meter-min><code>min</code></dfn>, <dfn
- id=max0 title=dom-meter-max><code>max</code></dfn>, <dfn id=value2
+ id=max2 title=dom-meter-max><code>max</code></dfn>, <dfn id=value4
title=dom-meter-value><code>value</code></dfn>, <dfn id=low0
title=dom-meter-low><code>low</code></dfn>, <dfn id=high0
title=dom-meter-high><code>high</code></dfn>, and <dfn id=optimum0
@@ -11118,7 +11304,7 @@
href="#textcontent">textContent</a></code> never affects the DOM values.
<p class=big-issue>Would be cool to have the <code title=dom-meter-value><a
- href="#value2">value</a></code> DOM attribute update the <code><a
+ href="#value4">value</a></code> DOM attribute update the <code><a
href="#textcontent">textContent</a></code> in-line...</p>
<!-- XXX
should we also look inside the title="" attribute?
@@ -11126,191 +11312,6 @@
should we make the contents accessible in some way, e.g. as a tooltip?
-->
- <h4 id=the-progress><span class=secno>3.12.12. </span>The <dfn
- id=progress><code>progress</code></dfn> element</h4>
-
- <p><a href="#strictly">Strictly inline-level content</a>.
-
- <dl class=element>
- <dt>Contexts in which this element may be used:
-
- <dd>Where <a href="#strictly">strictly inline-level content</a> is
- allowed.
-
- <dt>Content model:
-
- <dd><a href="#strictly">Strictly inline-level content</a>.
-
- <dt>Element-specific attributes:
-
- <dd><code title=attr-progress-value><a href="#value3">value</a></code>
-
- <dd><code title=attr-progress-max><a href="#max1">max</a></code>
-
- <dt>DOM interface:
-
- <dd>
- <pre
- class=idl>interface <dfn id=htmlprogresselement>HTMLProgressElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute float <a href="#value4" title=dom-progress-value>value</a>;
- attribute float <a href="#max2" title=dom-progress-max>max</a>;
- readonly attribute float <a href="#position" title=dom-progress-position>position</a>;
-};</pre>
- </dl>
-
- <p>The <code><a href="#progress">progress</a></code> element represents the
- completion progress of a task. The progress is either indeterminate,
- indicating that progress is being made but that it is not clear how much
- more work remains to be done before the task is complete (e.g. because the
- task is waiting for a remote host to respond), or the progress is a number
- in the range zero to a maximum, giving the fraction of work that has so
- far been completed.
-
- <p>There are two attributes that determine the current task completion
- represented by the element.
-
- <p>The <dfn id=value3 title=attr-progress-value><code>value</code></dfn>
- attribute specifies how much of the task has been completed, and the <dfn
- id=max1 title=attr-progress-max><code>max</code></dfn> attribute specifies
- how much work the task requires in total. The units are arbitrary and not
- specified.
-
- <p>Instead of using the attributes, authors are recommended to simply
- include the current value and the maximum value inline as text inside the
- element.
-
- <div class=example>
- <p>Here is a snippet of a Web application that shows the progress of some
- automated task:</p>
-
- <pre><section>
- <h2>Task Progress</h2>
- <p><label>Progress: <progress><span id="p">0</span>%</progress></p>
- <script>
- var progressBar = document.getElementById('p');
- function updateProgress(newValue) {
- progressBar.textContent = newValue;
- }
- </script>
-</section></pre>
-
- <p>(The <code>updateProgress()</code> method in this example would be
- called by some other code on the page to update the actual progress bar
- as the task progressed.)</p>
- </div>
-
- <p><strong>Author requirements</strong>: The <code
- title=attr-progress-max><a href="#max1">max</a></code> and <code
- title=attr-progress-value><a href="#value3">value</a></code> attributes,
- when present, must have values that are <a href="#valid1" title="valid
- floating point number">valid floating point numbers</a>. The <code
- title=attr-progress-max><a href="#max1">max</a></code> attribute, if
- present, must have a value greater than zero. The <code
- title=attr-progress-value><a href="#value3">value</a></code> attribute, if
- present, must have a value equal to or greater than zero, and less than or
- equal to the value of the <code title=attr-progress-max><a
- href="#max1">max</a></code> attribute, if present.
-
- <p><strong>User agent requirements</strong>: User agents must parse the
- <code title=attr-progress-max><a href="#max1">max</a></code> and <code
- title=attr-progress-value><a href="#value3">value</a></code> attributes'
- values according to the <a href="#rules1">rules for parsing floating point
- number values</a>.
-
- <p>If the <code title=attr-progress-value><a
- href="#value3">value</a></code> attribute is omitted, then user agents
- must also parse the <code><a href="#textcontent">textContent</a></code> of
- the <code><a href="#progress">progress</a></code> element in question
- using the <a href="#steps">steps for finding one or two numbers of a ratio
- in a string</a>. These steps will return nothing, one number, one number
- with a denominator punctuation character, or two numbers.
-
- <p>Using the results of this processing, user agents must determine whether
- the progress bar is an indeterminate progress bar, or whether it is a
- determinate progress bar, and in the latter case, what its current and
- maximum values are, all as follows:
-
- <ol>
- <li>If the <code title=attr-progress-max><a href="#max1">max</a></code>
- attribute is omitted, and the <code title=attr-progress-value><a
- href="#value3">value</a></code> is omitted, and the results of parsing
- the <code><a href="#textcontent">textContent</a></code> was nothing, then
- the progress bar is an indeterminate progress bar. Abort these steps.
-
- <li>Otherwise, it is a determinate progress bar.
-
- <li>If the <code title=attr-progress-max><a href="#max1">max</a></code>
- attribute is included, then, if a value could be parsed out of it, then
- the maximum value is that value.
-
- <li>Otherwise, if the <code title=attr-progress-max><a
- href="#max1">max</a></code> attribute is absent but the <code
- title=attr-progress-value><a href="#value3">value</a></code> attribute is
- present, or, if the <code title=attr-progress-max><a
- href="#max1">max</a></code> attribute is present but no value could be
- parsed from it, then the maximum is 1.
-
- <li>Otherwise, if neither attribute is included, then, if the <code><a
- href="#textcontent">textContent</a></code> contained one number with an
- associated denominator punctuation character, then the maximum value is
- the <span>value associated with that denominator punctuation
- character</span>; otherwise, if the <code><a
- href="#textcontent">textContent</a></code> contained two numbers, the
- maximum value is the higher of the two values; otherwise, the maximum
- value is 1.
-
- <li>If the <code title=attr-progress-value><a
- href="#value3">value</a></code> attribute is present on the element and a
- value could be parsed out of it, that value is the current value of the
- progress bar. Otherwise, if the attribute is present but no value could
- be parsed from it, the current value is zero.
-
- <li>Otherwise if the <code title=attr-progress-value><a
- href="#value3">value</a></code> attribute is absent and the <code
- title=attr-progress-max><a href="#max1">max</a></code> attribute is
- present, then, if the <code><a href="#textcontent">textContent</a></code>
- was parsed and found to contain just one number, with no associated
- denominator punctuation character, then the current value is that number.
- Otherwise, if the <code title=attr-progress-value><a
- href="#value3">value</a></code> attribute is absent and the <code
- title=attr-progress-max><a href="#max1">max</a></code> attribute is
- present then the current value is zero.
-
- <li>Otherwise, if neither attribute is present, then the current value is
- the lower of the one or two numbers that were found in the <code><a
- href="#textcontent">textContent</a></code> of the element.
-
- <li>If the maximum value is less than or equal to zero, then it is reset
- to 1.
-
- <li>If the current value is less than zero, then it is reset to zero.
-
- <li>Finally, if the current value is greater than the maximum value, then
- the current value is reset to the maximum value.
- </ol>
-
- <p><strong>UA requirements for showing the progress bar</strong>: When
- representing a <code><a href="#progress">progress</a></code> element to
- the user, the UA should indicate whether it is a determinate or
- indeterminate progress bar, and in the former case, should indicate the
- relative position of the current value relative to the maximum value.
-
- <p>The <dfn id=max2 title=dom-progress-max><code>max</code></dfn> and <dfn
- id=value4 title=dom-progress-value><code>value</code></dfn> DOM attributes
- must reflect the elements' content attributes of the same name. When the
- relevant content attributes are absent, the DOM attributes must return
- zero. The value parsed from the <code><a
- href="#textcontent">textContent</a></code> never affects the DOM values.
-
- <p class=big-issue>Would be cool to have the <code
- title=dom-progress-value><a href="#value4">value</a></code> DOM attribute
- update the <code><a href="#textcontent">textContent</a></code> in-line...
-
- <p>If the progress bar is an indeterminate progress bar, then the <dfn
- id=position title=dom-progress-position><code>position</code></dfn> DOM
- attribute must return -1. Otherwise, it must return the result of dividing
- the current value by the maximum value.
-
<h4 id=the-code><span class=secno>3.12.13. </span>The <dfn
id=code><code>code</code></dfn> element</h4>
Modified: source
===================================================================
--- source 2007-10-19 04:48:05 UTC (rev 1078)
+++ source 2007-10-19 18:52:47 UTC (rev 1079)
@@ -8882,7 +8882,184 @@
+ <h4>The <dfn><code>progress</code></dfn> element</h4>
+
+ <p><span>Strictly inline-level content</span>.</p>
+
+ <dl class="element">
+ <dt>Contexts in which this element may be used:</dt>
+ <dd>Where <span>strictly inline-level content</span> is allowed.</dd>
+ <dt>Content model:</dt>
+ <dd><span>Strictly inline-level content</span>.</dd>
+ <dt>Element-specific attributes:</dt>
+ <dd><code title="attr-progress-value">value</code></dd>
+ <dd><code title="attr-progress-max">max</code></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+<pre class="idl">interface <dfn>HTMLProgressElement</dfn> : <span>HTMLElement</span> {
+ attribute float <span title="dom-progress-value">value</span>;
+ attribute float <span title="dom-progress-max">max</span>;
+ readonly attribute float <span title="dom-progress-position">position</span>;
+};</pre>
+ </dd>
+ </dl>
+
+ <p>The <code>progress</code> element represents the completion
+ progress of a task. The progress is either indeterminate, indicating
+ that progress is being made but that it is not clear how much more
+ work remains to be done before the task is complete (e.g. because
+ the task is waiting for a remote host to respond), or the progress
+ is a number in the range zero to a maximum, giving the fraction of
+ work that has so far been completed.</p>
+
+ <p>There are two attributes that determine the current task
+ completion represented by the element.</p>
+
+ <p>The <dfn title="attr-progress-value"><code>value</code></dfn>
+ attribute specifies how much of the task has been completed, and the
+ <dfn title="attr-progress-max"><code>max</code></dfn> attribute
+ specifies how much work the task requires in total. The units are
+ arbitrary and not specified.</p>
+
+ <p>Instead of using the attributes, authors are recommended to
+ simply include the current value and the maximum value inline as
+ text inside the element.</p>
+
+ <div class="example">
+ <p>Here is a snippet of a Web application that shows the progress
+ of some automated task:</p>
+ <pre><section>
+ <h2>Task Progress</h2>
+ <p><label>Progress: <progress><span id="p">0</span>%</progress></p>
+ <script>
+ var progressBar = document.getElementById('p');
+ function updateProgress(newValue) {
+ progressBar.textContent = newValue;
+ }
+ </script>
+</section></pre>
+ <p>(The <code>updateProgress()</code> method in this example would
+ be called by some other code on the page to update the actual
+ progress bar as the task progressed.)</p>
+ </div>
+
+ <p><strong>Author requirements</strong>: The <code
+ title="attr-progress-max">max</code> and <code
+ title="attr-progress-value">value</code> attributes, when present,
+ must have values that are <span title="valid floating point
+ number">valid floating point numbers</span>. The <code
+ title="attr-progress-max">max</code> attribute, if present, must
+ have a value greater than zero. The <code
+ title="attr-progress-value">value</code> attribute, if present, must
+ have a value equal to or greater than zero, and less than or equal
+ to the value of the <code title="attr-progress-max">max</code>
+ attribute, if present.</p>
+
+ <p><strong>User agent requirements</strong>: User agents must parse
+ the <code title="attr-progress-max">max</code> and <code
+ title="attr-progress-value">value</code> attributes' values
+ according to the <span>rules for parsing floating point number
+ values</span>.</p>
+
+ <p>If the <code title="attr-progress-value">value</code> attribute
+ is omitted, then user agents must also parse the
+ <code>textContent</code> of the <code>progress</code> element in
+ question using the <span>steps for finding one or two numbers of a
+ ratio in a string</span>. These steps will return nothing, one
+ number, one number with a denominator punctuation character, or two
+ numbers.</p>
+
+ <p>Using the results of this processing, user agents must determine
+ whether the progress bar is an indeterminate progress bar, or
+ whether it is a determinate progress bar, and in the latter case,
+ what its current and maximum values are, all as follows:</p>
+
+ <ol>
+
+ <li>If the <code title="attr-progress-max">max</code> attribute is
+ omitted, and the <code title="attr-progress-value">value</code> is
+ omitted, and the results of parsing the <code>textContent</code>
+ was nothing, then the progress bar is an indeterminate progress
+ bar. Abort these steps.</li>
+
+ <li>Otherwise, it is a determinate progress bar.</li>
+
+ <li>If the <code title="attr-progress-max">max</code> attribute is
+ included, then, if a value could be parsed out of it, then the
+ maximum value is that value.</li>
+
+ <li>Otherwise, if the <code title="attr-progress-max">max</code>
+ attribute is absent but the <code
+ title="attr-progress-value">value</code> attribute is present, or,
+ if the <code title="attr-progress-max">max</code> attribute is
+ present but no value could be parsed from it, then the maximum is
+ 1.</li>
+
+ <li>Otherwise, if neither attribute is included, then, if the
+ <code>textContent</code> contained one number with an associated
+ denominator punctuation character, then the maximum value is the
+ <span>value associated with that denominator punctuation
+ character</span>; otherwise, if the <code>textContent</code>
+ contained two numbers, the maximum value is the higher of the two
+ values; otherwise, the maximum value is 1.</li>
+
+ <li>If the <code title="attr-progress-value">value</code> attribute
+ is present on the element and a value could be parsed out of it,
+ that value is the current value of the progress bar. Otherwise, if
+ the attribute is present but no value could be parsed from it, the
+ current value is zero.</li>
+
+ <li>Otherwise if the <code title="attr-progress-value">value</code>
+ attribute is absent and the <code
+ title="attr-progress-max">max</code> attribute is present, then, if
+ the <code>textContent</code> was parsed and found to contain just
+ one number, with no associated denominator punctuation character,
+ then the current value is that number. Otherwise, if the <code
+ title="attr-progress-value">value</code> attribute is absent and
+ the <code title="attr-progress-max">max</code> attribute is present
+ then the current value is zero.</li>
+
+ <li>Otherwise, if neither attribute is present, then the current
+ value is the lower of the one or two numbers that were found in the
+ <code>textContent</code> of the element.</li>
+
+ <li>If the maximum value is less than or equal to zero, then it is
+ reset to 1.</li>
+
+ <li>If the current value is less than zero, then it is reset to
+ zero.</li>
+
+ <li>Finally, if the current value is greater than the maximum
+ value, then the current value is reset to the maximum value.</li>
+
+ </ol>
+
+ <p><strong>UA requirements for showing the progress bar</strong>:
+ When representing a <code>progress</code> element to the user, the
+ UA should indicate whether it is a determinate or indeterminate
+ progress bar, and in the former case, should indicate the relative
+ position of the current value relative to the maximum value.</p>
+
+ <p>The <dfn title="dom-progress-max"><code>max</code></dfn> and <dfn
+ title="dom-progress-value"><code>value</code></dfn> DOM attributes
+ must reflect the elements' content attributes of the same name. When
+ the relevant content attributes are absent, the DOM attributes must
+ return zero. The value parsed from the <code>textContent</code>
+ never affects the DOM values.</p>
+
+ <p class="big-issue">Would be cool to have the <code
+ title="dom-progress-value">value</code> DOM attribute update the
+ <code>textContent</code> in-line...</p>
+
+ <p>If the progress bar is an indeterminate progress bar, then the
+ <dfn title="dom-progress-position"><code>position</code></dfn> DOM
+ attribute must return -1. Otherwise, it must return the result of
+ dividing the current value by the maximum value.</p>
+
+
+
<h4>The <dfn><code>meter</code></dfn> element</h4>
+ <!-- Keep this after <progress> and NOT close to <time> -->
<p><span>Strictly inline-level content</span>.</p>
@@ -9215,181 +9392,6 @@
- <h4>The <dfn><code>progress</code></dfn> element</h4>
-
- <p><span>Strictly inline-level content</span>.</p>
-
- <dl class="element">
- <dt>Contexts in which this element may be used:</dt>
- <dd>Where <span>strictly inline-level content</span> is allowed.</dd>
- <dt>Content model:</dt>
- <dd><span>Strictly inline-level content</span>.</dd>
- <dt>Element-specific attributes:</dt>
- <dd><code title="attr-progress-value">value</code></dd>
- <dd><code title="attr-progress-max">max</code></dd>
- <dt>DOM interface:</dt>
- <dd>
-<pre class="idl">interface <dfn>HTMLProgressElement</dfn> : <span>HTMLElement</span> {
- attribute float <span title="dom-progress-value">value</span>;
- attribute float <span title="dom-progress-max">max</span>;
- readonly attribute float <span title="dom-progress-position">position</span>;
-};</pre>
- </dd>
- </dl>
-
- <p>The <code>progress</code> element represents the completion
- progress of a task. The progress is either indeterminate, indicating
- that progress is being made but that it is not clear how much more
- work remains to be done before the task is complete (e.g. because
- the task is waiting for a remote host to respond), or the progress
- is a number in the range zero to a maximum, giving the fraction of
- work that has so far been completed.</p>
-
- <p>There are two attributes that determine the current task
- completion represented by the element.</p>
-
- <p>The <dfn title="attr-progress-value"><code>value</code></dfn>
- attribute specifies how much of the task has been completed, and the
- <dfn title="attr-progress-max"><code>max</code></dfn> attribute
- specifies how much work the task requires in total. The units are
- arbitrary and not specified.</p>
-
- <p>Instead of using the attributes, authors are recommended to
- simply include the current value and the maximum value inline as
- text inside the element.</p>
-
- <div class="example">
- <p>Here is a snippet of a Web application that shows the progress
- of some automated task:</p>
- <pre><section>
- <h2>Task Progress</h2>
- <p><label>Progress: <progress><span id="p">0</span>%</progress></p>
- <script>
- var progressBar = document.getElementById('p');
- function updateProgress(newValue) {
- progressBar.textContent = newValue;
- }
- </script>
-</section></pre>
- <p>(The <code>updateProgress()</code> method in this example would
- be called by some other code on the page to update the actual
- progress bar as the task progressed.)</p>
- </div>
-
- <p><strong>Author requirements</strong>: The <code
- title="attr-progress-max">max</code> and <code
- title="attr-progress-value">value</code> attributes, when present,
- must have values that are <span title="valid floating point
- number">valid floating point numbers</span>. The <code
- title="attr-progress-max">max</code> attribute, if present, must
- have a value greater than zero. The <code
- title="attr-progress-value">value</code> attribute, if present, must
- have a value equal to or greater than zero, and less than or equal
- to the value of the <code title="attr-progress-max">max</code>
- attribute, if present.</p>
-
- <p><strong>User agent requirements</strong>: User agents must parse
- the <code title="attr-progress-max">max</code> and <code
- title="attr-progress-value">value</code> attributes' values
- according to the <span>rules for parsing floating point number
- values</span>.</p>
-
- <p>If the <code title="attr-progress-value">value</code> attribute
- is omitted, then user agents must also parse the
- <code>textContent</code> of the <code>progress</code> element in
- question using the <span>steps for finding one or two numbers of a
- ratio in a string</span>. These steps will return nothing, one
- number, one number with a denominator punctuation character, or two
- numbers.</p>
-
- <p>Using the results of this processing, user agents must determine
- whether the progress bar is an indeterminate progress bar, or
- whether it is a determinate progress bar, and in the latter case,
- what its current and maximum values are, all as follows:</p>
-
- <ol>
-
- <li>If the <code title="attr-progress-max">max</code> attribute is
- omitted, and the <code title="attr-progress-value">value</code> is
- omitted, and the results of parsing the <code>textContent</code>
- was nothing, then the progress bar is an indeterminate progress
- bar. Abort these steps.</li>
-
- <li>Otherwise, it is a determinate progress bar.</li>
-
- <li>If the <code title="attr-progress-max">max</code> attribute is
- included, then, if a value could be parsed out of it, then the
- maximum value is that value.</li>
-
- <li>Otherwise, if the <code title="attr-progress-max">max</code>
- attribute is absent but the <code
- title="attr-progress-value">value</code> attribute is present, or,
- if the <code title="attr-progress-max">max</code> attribute is
- present but no value could be parsed from it, then the maximum is
- 1.</li>
-
- <li>Otherwise, if neither attribute is included, then, if the
- <code>textContent</code> contained one number with an associated
- denominator punctuation character, then the maximum value is the
- <span>value associated with that denominator punctuation
- character</span>; otherwise, if the <code>textContent</code>
- contained two numbers, the maximum value is the higher of the two
- values; otherwise, the maximum value is 1.</li>
-
- <li>If the <code title="attr-progress-value">value</code> attribute
- is present on the element and a value could be parsed out of it,
- that value is the current value of the progress bar. Otherwise, if
- the attribute is present but no value could be parsed from it, the
- current value is zero.</li>
-
- <li>Otherwise if the <code title="attr-progress-value">value</code>
- attribute is absent and the <code
- title="attr-progress-max">max</code> attribute is present, then, if
- the <code>textContent</code> was parsed and found to contain just
- one number, with no associated denominator punctuation character,
- then the current value is that number. Otherwise, if the <code
- title="attr-progress-value">value</code> attribute is absent and
- the <code title="attr-progress-max">max</code> attribute is present
- then the current value is zero.</li>
-
- <li>Otherwise, if neither attribute is present, then the current
- value is the lower of the one or two numbers that were found in the
- <code>textContent</code> of the element.</li>
-
- <li>If the maximum value is less than or equal to zero, then it is
- reset to 1.</li>
-
- <li>If the current value is less than zero, then it is reset to
- zero.</li>
-
- <li>Finally, if the current value is greater than the maximum
- value, then the current value is reset to the maximum value.</li>
-
- </ol>
-
- <p><strong>UA requirements for showing the progress bar</strong>:
- When representing a <code>progress</code> element to the user, the
- UA should indicate whether it is a determinate or indeterminate
- progress bar, and in the former case, should indicate the relative
- position of the current value relative to the maximum value.</p>
-
- <p>The <dfn title="dom-progress-max"><code>max</code></dfn> and <dfn
- title="dom-progress-value"><code>value</code></dfn> DOM attributes
- must reflect the elements' content attributes of the same name. When
- the relevant content attributes are absent, the DOM attributes must
- return zero. The value parsed from the <code>textContent</code>
- never affects the DOM values.</p>
-
- <p class="big-issue">Would be cool to have the <code
- title="dom-progress-value">value</code> DOM attribute update the
- <code>textContent</code> in-line...</p>
-
- <p>If the progress bar is an indeterminate progress bar, then the
- <dfn title="dom-progress-position"><code>position</code></dfn> DOM
- attribute must return -1. Otherwise, it must return the result of
- dividing the current value by the maximum value.</p>
-
-
<h4>The <dfn><code>code</code></dfn> element</h4>
<p><span>Strictly inline-level content</span>.</p>
More information about the Commit-Watchers
mailing list