Skip to content

Commit

Permalink
[e] (0) Move the enumerated attributes section up. (credit: sp) (bug …
Browse files Browse the repository at this point in the history
…6637)

git-svn-id: http://svn.whatwg.org/webapps@2942 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Mar 31, 2009
1 parent 5dbfa5b commit ace4ab9
Show file tree
Hide file tree
Showing 2 changed files with 133 additions and 133 deletions.
170 changes: 85 additions & 85 deletions index
Expand Up @@ -238,28 +238,28 @@
<ol>
<li><a href=#common-parser-idioms><span class=secno>2.4.1 </span>Common parser idioms</a></li>
<li><a href=#boolean-attributes><span class=secno>2.4.2 </span>Boolean attributes</a></li>
<li><a href=#numbers><span class=secno>2.4.3 </span>Numbers</a>
<li><a href=#keywords-and-enumerated-attributes><span class=secno>2.4.3 </span>Keywords and enumerated attributes</a></li>
<li><a href=#numbers><span class=secno>2.4.4 </span>Numbers</a>
<ol>
<li><a href=#non-negative-integers><span class=secno>2.4.3.1 </span>Non-negative integers</a></li>
<li><a href=#signed-integers><span class=secno>2.4.3.2 </span>Signed integers</a></li>
<li><a href=#real-numbers><span class=secno>2.4.3.3 </span>Real numbers</a></li>
<li><a href=#ratios><span class=secno>2.4.3.4 </span>Ratios</a></li>
<li><a href=#percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</a></li>
<li><a href=#lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</a></li>
<li><a href=#lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</a></ol></li>
<li><a href=#dates-and-times><span class=secno>2.4.4 </span>Dates and times</a>
<li><a href=#non-negative-integers><span class=secno>2.4.4.1 </span>Non-negative integers</a></li>
<li><a href=#signed-integers><span class=secno>2.4.4.2 </span>Signed integers</a></li>
<li><a href=#real-numbers><span class=secno>2.4.4.3 </span>Real numbers</a></li>
<li><a href=#ratios><span class=secno>2.4.4.4 </span>Ratios</a></li>
<li><a href=#percentages-and-dimensions><span class=secno>2.4.4.5 </span>Percentages and lengths</a></li>
<li><a href=#lists-of-integers><span class=secno>2.4.4.6 </span>Lists of integers</a></li>
<li><a href=#lists-of-dimensions><span class=secno>2.4.4.7 </span>Lists of dimensions</a></ol></li>
<li><a href=#dates-and-times><span class=secno>2.4.5 </span>Dates and times</a>
<ol>
<li><a href=#months><span class=secno>2.4.4.1 </span>Months</a></li>
<li><a href=#dates><span class=secno>2.4.4.2 </span>Dates</a></li>
<li><a href=#times><span class=secno>2.4.4.3 </span>Times</a></li>
<li><a href=#local-dates-and-times><span class=secno>2.4.4.4 </span>Local dates and times</a></li>
<li><a href=#global-dates-and-times><span class=secno>2.4.4.5 </span>Global dates and times</a></li>
<li><a href=#weeks><span class=secno>2.4.4.6 </span>Weeks</a></li>
<li><a href=#vaguer-moments-in-time><span class=secno>2.4.4.7 </span>Vaguer moments in time</a></ol></li>
<li><a href=#colors><span class=secno>2.4.5 </span>Colors</a></li>
<li><a href=#space-separated-tokens><span class=secno>2.4.6 </span>Space-separated tokens</a></li>
<li><a href=#comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</a></li>
<li><a href=#keywords-and-enumerated-attributes><span class=secno>2.4.8 </span>Keywords and enumerated attributes</a></li>
<li><a href=#months><span class=secno>2.4.5.1 </span>Months</a></li>
<li><a href=#dates><span class=secno>2.4.5.2 </span>Dates</a></li>
<li><a href=#times><span class=secno>2.4.5.3 </span>Times</a></li>
<li><a href=#local-dates-and-times><span class=secno>2.4.5.4 </span>Local dates and times</a></li>
<li><a href=#global-dates-and-times><span class=secno>2.4.5.5 </span>Global dates and times</a></li>
<li><a href=#weeks><span class=secno>2.4.5.6 </span>Weeks</a></li>
<li><a href=#vaguer-moments-in-time><span class=secno>2.4.5.7 </span>Vaguer moments in time</a></ol></li>
<li><a href=#colors><span class=secno>2.4.6 </span>Colors</a></li>
<li><a href=#space-separated-tokens><span class=secno>2.4.7 </span>Space-separated tokens</a></li>
<li><a href=#comma-separated-tokens><span class=secno>2.4.8 </span>Comma-separated tokens</a></li>
<li><a href=#syntax-references><span class=secno>2.4.9 </span>References</a></ol></li>
<li><a href=#urls><span class=secno>2.5 </span>URLs</a>
<ol>
Expand Down Expand Up @@ -2089,9 +2089,55 @@
be omitted altogether.</p>


<h4 id=numbers><span class=secno>2.4.3 </span>Numbers</h4>

<h5 id=non-negative-integers><span class=secno>2.4.3.1 </span>Non-negative integers</h5>
<h4 id=keywords-and-enumerated-attributes><span class=secno>2.4.3 </span>Keywords and enumerated attributes</h4>

<p>Some attributes are defined as taking one of a finite set of
keywords. Such attributes are called <dfn id=enumerated-attribute title="enumerated
attribute">enumerated attributes</dfn>. The keywords are each
defined to map to a particular <em>state</em> (several keywords
might map to the same state, in which case some of the keywords are
synonyms of each other; additionally, some of the keywords can be
said to be non-conforming, and are only in the specification for
historical reasons). In addition, two default states can be
given. The first is the <i>invalid value default</i>, the second
is the <i>missing value default</i>.</p>

<p>If an enumerated attribute is specified, the attribute's value
must be an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for one of the
given keywords that are not said to be non-conforming, with no
leading or trailing whitespace.</p>

<p>When the attribute is specified, if its value is an <a href=#ascii-case-insensitive>ASCII
case-insensitive</a> match for one of the given keywords then
that keyword's state is the state that the attribute represents. If
the attribute value matches none of the given keywords, but the
attribute has an <i>invalid value default</i>, then the attribute
represents that state. Otherwise, if the attribute value matches
none of the keywords but there is a <i>missing value default</i>
state defined, then <em>that</em> is the state represented by the
attribute. Otherwise, there is no default, and invalid values must
be ignored.</p>

<p>When the attribute is <em>not</em> specified, if there is a
<i>missing value default</i> state defined, then that is the state
represented by the (missing) attribute. Otherwise, the absence of
the attribute means that there is no state represented.</p>

<p class=note>The empty string can be one of the keywords in some
cases. For example the <code title=attr-contenteditable><a href=#attr-contenteditable>contenteditable</a></code> attribute has
two states: <i>true</i>, matching the <code title="">true</code>
keyword and the empty string, <i>false</i>, matching <code title="">false</code> and all other keywords (it's the <i>invalid
value default</i>). It could further be thought of as having a
third state <i>inherit</i>, which would be the default when the
attribute is not specified at all (the <i>missing value
default</i>), but for various reasons that isn't the way this
specification actually defines it.</p>


<h4 id=numbers><span class=secno>2.4.4 </span>Numbers</h4>

<h5 id=non-negative-integers><span class=secno>2.4.4.1 </span>Non-negative integers</h5>

<p>A string is a <dfn id=valid-non-negative-integer>valid non-negative integer</dfn> if it
consists of one of more characters in the range U+0030 DIGIT ZERO
Expand Down Expand Up @@ -2156,7 +2202,7 @@
</ol></div>


<h5 id=signed-integers><span class=secno>2.4.3.2 </span>Signed integers</h5>
<h5 id=signed-integers><span class=secno>2.4.4.2 </span>Signed integers</h5>

<p>A string is a <dfn id=valid-integer>valid integer</dfn> if it consists of one of
more characters in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT
Expand Down Expand Up @@ -2240,7 +2286,7 @@
</ol></div>


<h5 id=real-numbers><span class=secno>2.4.3.3 </span>Real numbers</h5>
<h5 id=real-numbers><span class=secno>2.4.4.3 </span>Real numbers</h5>

<p>A string is a <dfn id=valid-floating-point-number>valid floating point number</dfn> if it
consists of:</p>
Expand Down Expand Up @@ -2424,7 +2470,7 @@
</ol></div>


<h5 id=ratios><span class=secno>2.4.3.4 </span>Ratios</h5>
<h5 id=ratios><span class=secno>2.4.4.4 </span>Ratios</h5>

<p class=note>The algorithms described in this section are used by
the <code><a href=#the-progress-element>progress</a></code> and <code><a href=#the-meter-element>meter</a></code> elements.</p>
Expand Down Expand Up @@ -2551,7 +2597,7 @@


<div class=impl>
<h5 id=percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</h5>
<h5 id=percentages-and-dimensions><span class=secno>2.4.4.5 </span>Percentages and lengths</h5>
<!--(percentages are not used in valid html5)
<p>A string is a <dfn>valid dimension value</dfn> if it consists of
a character in the range U+0031 DIGIT ONE (1) to U+0039 DIGIT NINE
Expand Down Expand Up @@ -2641,7 +2687,7 @@
</ol></div>


<h5 id=lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</h5>
<h5 id=lists-of-integers><span class=secno>2.4.4.6 </span>Lists of integers</h5>

<p>A <dfn id=valid-list-of-integers>valid list of integers</dfn> is a number of <a href=#valid-integer title="valid integer">valid integers</a> separated by U+002C
COMMA characters, with no other characters (e.g. no <a href=#space-character title="space character">space characters</a>). In addition, there
Expand Down Expand Up @@ -2911,7 +2957,7 @@

<div class=impl>

<h5 id=lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</h5>
<h5 id=lists-of-dimensions><span class=secno>2.4.4.7 </span>Lists of dimensions</h5>

<!-- no definition of a type since no conforming feature uses this
syntax (it's only used in cols="" and rows="" on <frameset> -->
Expand Down Expand Up @@ -3015,7 +3061,7 @@
</ol></div>


<h4 id=dates-and-times><span class=secno>2.4.4 </span>Dates and times</h4>
<h4 id=dates-and-times><span class=secno>2.4.5 </span>Dates and times</h4>

<p>In the algorithms below, the <dfn id=number-of-days-in-month-month-of-year-year>number of days in month <var title="">month</var> of year <var title="">year</var></dfn> is:
<em>31</em> if <var title="">month</var> is 1, 3, 5, 7, 8, 10, or
Expand All @@ -3030,7 +3076,7 @@
numbers in base ten.</p>


<h5 id=months><span class=secno>2.4.4.1 </span>Months</h5>
<h5 id=months><span class=secno>2.4.5.1 </span>Months</h5>

<p>A <dfn id=concept-month title=concept-month>month</dfn> consists of a specific
proleptic Gregorian date with no timezone information and no date
Expand Down Expand Up @@ -3102,7 +3148,7 @@
</ol></div>


<h5 id=dates><span class=secno>2.4.4.2 </span>Dates</h5>
<h5 id=dates><span class=secno>2.4.5.2 </span>Dates</h5>

<p>A <dfn id=concept-date title=concept-date>date</dfn> consists of a specific
proleptic Gregorian date with no timezone information, consisting of
Expand Down Expand Up @@ -3174,7 +3220,7 @@
</ol></div>


<h5 id=times><span class=secno>2.4.4.3 </span>Times</h5>
<h5 id=times><span class=secno>2.4.5.3 </span>Times</h5>

<p>A <dfn id=concept-time title=concept-time>time</dfn> consists of a specific
time with no timezone information, consisting of an hour, a minute,
Expand Down Expand Up @@ -3311,7 +3357,7 @@
</ol></div>


<h5 id=local-dates-and-times><span class=secno>2.4.4.4 </span>Local dates and times</h5>
<h5 id=local-dates-and-times><span class=secno>2.4.5.4 </span>Local dates and times</h5>

<p>A <dfn id=concept-datetime-local title=concept-datetime-local>local date and time</dfn>
consists of a specific proleptic Gregorian date, consisting of a
Expand Down Expand Up @@ -3364,7 +3410,7 @@



<h5 id=global-dates-and-times><span class=secno>2.4.4.5 </span>Global dates and times</h5>
<h5 id=global-dates-and-times><span class=secno>2.4.5.5 </span>Global dates and times</h5>

<p>A <dfn id=concept-datetime title=concept-datetime>global date and time</dfn>
consists of a specific proleptic Gregorian date, consisting of a
Expand Down Expand Up @@ -3570,7 +3616,7 @@
</ol></div>


<h5 id=weeks><span class=secno>2.4.4.6 </span>Weeks</h5>
<h5 id=weeks><span class=secno>2.4.5.6 </span>Weeks</h5>

<p>A <dfn id=concept-week title=concept-week>week</dfn> consists of a week-year
number and a week number representing a seven day period. Each
Expand Down Expand Up @@ -3664,7 +3710,7 @@
</ol></div>


<h5 id=vaguer-moments-in-time><span class=secno>2.4.4.7 </span>Vaguer moments in time</h5>
<h5 id=vaguer-moments-in-time><span class=secno>2.4.5.7 </span>Vaguer moments in time</h5>

<p>A <dfn id=date-or-time-string>date or time string</dfn> consists of either a <a href=#concept-date title=concept-date>date</a>, a <a href=#concept-time title=concept-time>time</a>, or a <a href=#concept-datetime title=concept-datetime>global date and time</a>.</p>

Expand Down Expand Up @@ -3765,7 +3811,7 @@
</ol></div>


<h4 id=colors><span class=secno>2.4.5 </span>Colors</h4>
<h4 id=colors><span class=secno>2.4.6 </span>Colors</h4>

<p>A <dfn id=simple-color>simple color</dfn> consists of three 8-bit numbers in the
range 0..255, representing the red, green, and blue components of
Expand Down Expand Up @@ -3953,7 +3999,7 @@
opacity.</p>


<h4 id=space-separated-tokens><span class=secno>2.4.6 </span>Space-separated tokens</h4>
<h4 id=space-separated-tokens><span class=secno>2.4.7 </span>Space-separated tokens</h4>

<p>A <dfn id=set-of-space-separated-tokens>set of space-separated tokens</dfn> is a set of zero or
more words separated by one or more <a href=#space-character title="space
Expand Down Expand Up @@ -4072,7 +4118,7 @@



<h4 id=comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</h4>
<h4 id=comma-separated-tokens><span class=secno>2.4.8 </span>Comma-separated tokens</h4>

<p>A <dfn id=set-of-comma-separated-tokens>set of comma-separated tokens</dfn> is a set of zero or
more tokens each separated from the next by a single U+002C COMMA
Expand Down Expand Up @@ -4130,52 +4176,6 @@
</ol></div>



<h4 id=keywords-and-enumerated-attributes><span class=secno>2.4.8 </span>Keywords and enumerated attributes</h4>

<p>Some attributes are defined as taking one of a finite set of
keywords. Such attributes are called <dfn id=enumerated-attribute title="enumerated
attribute">enumerated attributes</dfn>. The keywords are each
defined to map to a particular <em>state</em> (several keywords
might map to the same state, in which case some of the keywords are
synonyms of each other; additionally, some of the keywords can be
said to be non-conforming, and are only in the specification for
historical reasons). In addition, two default states can be
given. The first is the <i>invalid value default</i>, the second
is the <i>missing value default</i>.</p>

<p>If an enumerated attribute is specified, the attribute's value
must be an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> match for one of the
given keywords that are not said to be non-conforming, with no
leading or trailing whitespace.</p>

<p>When the attribute is specified, if its value is an <span>ASCII
case-insensitively</span> match for one of the given keywords then
that keyword's state is the state that the attribute represents. If
the attribute value matches none of the given keywords, but the
attribute has an <i>invalid value default</i>, then the attribute
represents that state. Otherwise, if the attribute value matches
none of the keywords but there is a <i>missing value default</i>
state defined, then <em>that</em> is the state represented by the
attribute. Otherwise, there is no default, and invalid values must
be ignored.</p>

<p>When the attribute is <em>not</em> specified, if there is a
<i>missing value default</i> state defined, then that is the state
represented by the (missing) attribute. Otherwise, the absence of
the attribute means that there is no state represented.</p>

<p class=note>The empty string can be one of the keywords in some
cases. For example the <code title=attr-contenteditable><a href=#attr-contenteditable>contenteditable</a></code> attribute has
two states: <i>true</i>, matching the <code title="">true</code>
keyword and the empty string, <i>false</i>, matching <code title="">false</code> and all other keywords (it's the <i>invalid
value default</i>). It could further be thought of as having a
third state <i>inherit</i>, which would be the default when the
attribute is not specified at all (the <i>missing value
default</i>), but for various reasons that isn't the way this
specification actually defines it.</p>


<h4 id=syntax-references><span class=secno>2.4.9 </span>References</h4>

<p>A <dfn id=valid-hash-name-reference>valid hash-name reference</dfn> to an element of type <var title="">type</var> is a string consisting of a U+0023 NUMBER SIGN
Expand Down

0 comments on commit ace4ab9

Please sign in to comment.