[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