- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 10 Aug 2011 23:43:00 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-values
In directory hutz:/tmp/cvs-serv7207
Modified Files:
Overview.html Overview.src.html
Log Message:
Generic Values Reorganization Part I: Numeric datatypes
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.html,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -d -r1.72 -r1.73
--- Overview.html 10 Aug 2011 23:42:05 -0000 1.72
+++ Overview.html 10 Aug 2011 23:42:58 -0000 1.73
@@ -165,80 +165,76 @@
<li><a href="#syntax-and-terminology"><span class=secno>3. </span>Syntax
and terminology</a>
<ul class=toc>
- <li><a href="#integers"><span class=secno>3.1. </span>Integers</a>
-
- <li><a href="#numbers"><span class=secno>3.2. </span>Numbers</a>
-
- <li><a href="#numbers-with-unit-identifiers"><span class=secno>3.3.
+ <li><a href="#numbers-with-unit-identifiers"><span class=secno>3.1.
</span>Numbers with unit identifiers</a>
- <li><a href="#identifiers"><span class=secno>3.4. </span>Identifiers</a>
+ <li><a href="#identifiers"><span class=secno>3.2. </span>Identifiers</a>
- <li><a href="#strings"><span class=secno>3.5. </span>Strings</a>
+ <li><a href="#strings"><span class=secno>3.3. </span>Strings</a>
- <li><a href="#functional-notation"><span class=secno>3.6.
+ <li><a href="#functional-notation"><span class=secno>3.4.
</span>Functional notation</a>
</ul>
<li><a href="#keywords"><span class=secno>4. </span>Keywords</a>
- <li><a href="#generic-data-types"><span class=secno>5. </span>Generic data
- types</a>
+ <li><a href="#numeric-types"><span class=secno>5. </span> Numeric Data
+ Types</a>
<ul class=toc>
- <li><a href="#ltintegergt"><span class=secno>5.1.
- </span><integer></a>
+ <li><a href="#integers"><span class=secno>5.1. </span> Integers: the
+ ‘<code class=css><integer></code>’ type</a>
- <li><a href="#ltnumbergt"><span class=secno>5.2.
- </span><number></a>
+ <li><a href="#numbers"><span class=secno>5.2. </span> Numbers: the
+ ‘<code class=css><number></code>’ type</a>
- <li><a href="#ltlengthgt"><span class=secno>5.3.
+ <li><a href="#percentages"><span class=secno>5.3. </span> Percentages:
+ the ‘<code class=css><percentage></code>’ type</a>
+
+ <li><a href="#ltlengthgt"><span class=secno>5.4.
</span><length></a>
<ul class=toc>
<li><a href="#absolute-length-units-cm-mm.-in-pt-pc"><span
- class=secno>5.3.1. </span>Absolute length units: cm, mm. in, pt,
+ class=secno>5.4.1. </span>Absolute length units: cm, mm. in, pt,
pc</a>
- <li><a href="#relative-length-units"><span class=secno>5.3.2.
+ <li><a href="#relative-length-units"><span class=secno>5.4.2.
</span>Relative length units</a>
<ul class=toc>
- <li><a href="#the-em-unit"><span class=secno>5.3.2.1. </span>The
+ <li><a href="#the-em-unit"><span class=secno>5.4.2.1. </span>The
‘<code class=property>em</code>’ unit</a>
- <li><a href="#the-ex-unit"><span class=secno>5.3.2.2. </span>The
+ <li><a href="#the-ex-unit"><span class=secno>5.4.2.2. </span>The
‘<code class=property>ex</code>’ unit</a>
- <li><a href="#the-px-unit"><span class=secno>5.3.2.3. </span>The
+ <li><a href="#the-px-unit"><span class=secno>5.4.2.3. </span>The
‘<code class=property>px</code>’ unit</a>
- <li><a href="#the-rem-unit"><span class=secno>5.3.2.4. </span>The
+ <li><a href="#the-rem-unit"><span class=secno>5.4.2.4. </span>The
‘<code class=property>rem</code>’ unit</a>
- <li><a href="#the-vw-unit"><span class=secno>5.3.2.5. </span>The
+ <li><a href="#the-vw-unit"><span class=secno>5.4.2.5. </span>The
‘<code class=property>vw</code>’ unit</a>
- <li><a href="#the-vh-unit"><span class=secno>5.3.2.6. </span>The
+ <li><a href="#the-vh-unit"><span class=secno>5.4.2.6. </span>The
‘<code class=property>vh</code>’ unit</a>
- <li><a href="#the-vm-unit"><span class=secno>5.3.2.7. </span>The
+ <li><a href="#the-vm-unit"><span class=secno>5.4.2.7. </span>The
‘<code class=property>vm</code>’ unit</a>
</ul>
- <li><a href="#the-calc-min-and-max-functions"><span class=secno>5.3.3.
+ <li><a href="#the-calc-min-and-max-functions"><span class=secno>5.4.3.
</span>The ‘<code class=property>calc</code>’,
‘<code class=property>min</code>’ and ‘<code
class=property>max</code>’ functions</a>
</ul>
- <li><a href="#ltstringgt"><span class=secno>5.4.
+ <li><a href="#ltstringgt"><span class=secno>5.5.
</span><string></a>
- <li><a href="#ltcolorgt"><span class=secno>5.5. </span><color></a>
+ <li><a href="#ltcolorgt"><span class=secno>5.6. </span><color></a>
- <li><a href="#ltpercentagegt"><span class=secno>5.6.
- </span><percentage></a>
-
<li><a href="#ltanglegt"><span class=secno>5.7. </span><angle></a>
@@ -335,8 +331,8 @@
<li>basic data types, which appear between ‘<code
class=css><</code>’ and ‘<code
class=css>></code>’ (e.g., <a
- href="#ltlengthgt0"><code><length></code></a>,
- <code><percentage></code>, etc.).
+ href="#ltlengthgt0"><code><length></code></a>, <a
+ href="#percentage-value"><code><percentage></code></a>, etc.).
<li>types that have the same range of values as a property bearing the
same name (e.g., <code><'border-width'></code>
@@ -407,6 +403,9 @@
<li>A pair of numbers in curly braces ({<var>A</var>,<var>B</var>})
indicates that the preceding type, word, or group occurs at least
<var>A</var> and at most <var>B</var> times.
+
+ <li>A hash mark (#) indicates that the preceding type, word, or group
+ occurs one or more times, separated by comma tokens.
</ul>
<h3 id=value-types><span class=secno>2.4. </span> Component values and
@@ -435,74 +434,93 @@
definition fields
<div class=example>
- <p>Here are some sample properties with corresponding value definition
- fields:
-
- <table>
- <tbody>
+ <table class=data id=propvalues>
+ <thead>
<tr>
<th>Property
<th>Value definition field
+ <th>Example value
+
+ <tbody>
<tr>
- <td>min-width
+ <td>‘<code class=property>orphans</code>’
- <td><length> | <percentage> | inherit
+ <td><integer>
+
+ <td>‘<code class=css>3</code>’
<tr>
- <td>outline-color
+ <td>‘<code class=property>text-align</code>’
- <td><color> | invert | inherit
+ <td>left | right | center | justify
+
+ <td>‘<code class=css>center</code>’
<tr>
- <td>orphans
+ <td>‘<code class=property>padding-top</code>’
- <td><integer> | inherit
+ <td><length> | <percentage>
+
+ <td>‘<code class=css>5%</code>’
<tr>
- <td>pitch
+ <td>‘<code class=property>outline-color</code>’
- <td><frequency> | x-low | low | medium | high | x-high | inherit
+ <td><color> | invert
+
+ <td>‘<code class=css>#fefefe</code>’
<tr>
- <td>string-set
+ <td>‘<code class=property>text-decoration</code>’
- <td>[[ <identifier> <content-list>] [, <identifier>
- <content-list>]* ] | none
- </table>
- </div>
+ <td>none | underline || overline || line-through || blink
- <h2 id=syntax-and-terminology><span class=secno>3. </span>Syntax and
- terminology</h2>
+ <td>‘<code class=css>overline underline</code>’
- <p>The generic data types described in the next sections use some common
- syntactic building blocks and terms that are described in this section.
+ <tr>
+ <td>‘<code class=property>font-family</code>’
- <h3 id=integers><span class=secno>3.1. </span>Integers</h3>
+ <td><family-name>#
- <p>An <dfn id=integer>integer</dfn> is one or more decimal digits "0" to
- "9". Integers may be preceded by "-" or "+" to indicate the sign.
+ <td>‘<code class=css>"Gill Sans", Futura,
+ sans-serif</code>’
- <div class=example>
- <pre>
-orphans: 3
-</pre>
- </div>
+ <tr>
+ <td>‘<code class=property>border-width</code>’
- <h3 id=numbers><span class=secno>3.2. </span>Numbers</h3>
+ <td>[ <length> | thick | medium | thin ]{1,4}
- <p>A <dfn id=number>number</dfn> is either an integer, or zero or more
- decimal digits followed by a dot (.) followed by one or more decimal
- digits. Numbers may be preceded by "-" or "+" to indicate the sign.
+ <td>‘<code class=css>2px medium 4px</code>’
- <div class=example>
- <pre>
-line-height: 1.2
-</pre>
+ <tr>
+ <td>‘<code class=property>text-shadow</code>’
+
+ <td>[ inset? && [ <length>{2,4} && <color>? ] ]# | none
+
+ <td>‘<code class=css>3px 3px rgba(50%, 50%, 50%, 50%),
+ lemonchiffon 0 0 4px inset</code>’
+
+ <tr>
+ <td>‘<code class=property>voice-pitch</code>’
+
+ <td>
+ <pre class=value><frequency> && absolute |
+<!-- -->[[x-low | low | medium | high | x-high] ||
+<!-- --> [<frequency> | <semitones> | <percentage>]]</pre>
+
+ <td>‘<code class=css>-2st x-low</code>’
+ </table>
</div>
- <h3 id=numbers-with-unit-identifiers><span class=secno>3.3. </span>Numbers
+ <h2 id=syntax-and-terminology><span class=secno>3. </span>Syntax and
+ terminology</h2>
+
+ <p>The generic data types described in the next sections use some common
+ syntactic building blocks and terms that are described in this section.
+
+ <h3 id=numbers-with-unit-identifiers><span class=secno>3.1. </span>Numbers
with unit identifiers</h3>
<p>A <dfn id=number-with-a-unit-identifier>number with a unit
@@ -514,7 +532,7 @@
</pre>
</div>
- <h3 id=identifiers><span class=secno>3.4. </span>Identifiers</h3>
+ <h3 id=identifiers><span class=secno>3.2. </span>Identifiers</h3>
<p>An <dfn id=identifier>identifier</dfn> is an sequence of characters.
Identifiers cannot start with a digit, and there are other restrictions <a
@@ -528,7 +546,7 @@
</pre>
</div>
- <h3 id=strings><span class=secno>3.5. </span>Strings</h3>
+ <h3 id=strings><span class=secno>3.3. </span>Strings</h3>
<p>A <dfn id=string>string</dfn> is a sequence of characters enclosed by
double quotes or single quotes. Double quotes cannot occur inside double
@@ -567,7 +585,7 @@
</pre>
</div>
- <h3 id=functional-notation><span class=secno>3.6. </span>Functional
+ <h3 id=functional-notation><span class=secno>3.4. </span>Functional
notation</h3>
<p>Some values use a <dfn id=functional-notation0>functional notation</dfn>
@@ -627,23 +645,71 @@
default or not (which isn't obvious for some properties, such as
text-decoration and visibility).
- <h2 id=generic-data-types><span class=secno>5. </span>Generic data types</h2>
+ <h2 id=numeric-types><span class=secno>5. </span> Numeric Data Types</h2>
- <h3 id=ltintegergt><span class=secno>5.1. </span><integer></h3>
+ <h3 id=integers><span class=secno>5.1. </span> Integers: the ‘<a
+ href="#integer-value"><code class=css><integer></code></a>’
+ type</h3>
- <p>Integer values are denoted by <dfn id=ltintegergt0><integer></dfn>
- in the value definitions. Properties may restrict the integer value to
- some range. If the value is outside the allowed range, the declaration is
- ignored.
+ <p>Integer values are denoted by <dfn
+ id=integer-value><code><integer></code></dfn>. An <dfn
+ id=integer>integer</dfn> is one or more decimal digits ‘<code
+ class=css>0</code>’ through ‘<code class=css>9</code>’
+ and corresponds to a subset of the <a
+ href="#number"><code>NUMBER</code></a> token in the <a
+ href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+ Integers may be immediately preceded by ‘<code
+ class=css>-</code>’ or ‘<code class=css>+</code>’ to
+ indicate the sign.
- <h3 id=ltnumbergt><span class=secno>5.2. </span><number></h3>
+ <p>Properties may restrict the integer value to some range. If the value is
+ outside the allowed range, the declaration is invalid and must be <a
+ href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
- <p>Number values are denoted by <dfn id=ltnumbergt0><number></dfn> in
- the value definitions. Properties may restrict the number value to some
- range. If the value is outside the allowed range, the declaration is
- ignored.
+ <h3 id=numbers><span class=secno>5.2. </span> Numbers: the ‘<a
+ href="#number-value"><code class=css><number></code></a>’ type</h3>
- <h3 id=ltlengthgt><span class=secno>5.3. </span><length></h3>
+ <p>Number values are denoted by <dfn
+ id=number-value><code><number></code></dfn>. A <dfn
+ id=number>number</dfn> is either an <a href="#integer"><i>integer</i></a>,
+ or zero or more decimal digits followed by a dot (.) followed by one or
+ more decimal digits. It corresponds to the <a
+ href="#number"><code>NUMBER</code></a> token in the <a
+ href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+ Like integers, numbers may also be immediately preceded by ‘<code
+ class=css>-</code>’ or ‘<code class=css>+</code>’ to
+ indicate the sign.
+
+ <p>Properties may restrict the number value to some range. If the value is
+ outside the allowed range, the declaration is invalid and must be <a
+ href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
+
+ <h3 id=percentages><span class=secno>5.3. </span> Percentages: the
+ ‘<a href="#percentage-value"><code
+ class=css><percentage></code></a>’ type</h3>
+
+ <p>A percentage value is denoted by <dfn
+ id=percentage-value><code><percentage></code></dfn>, consists of a
+ <a href="#number-value"><i><number></i></a> immediately followed by
+ a percent sign ‘<code class=css>%</code>’. It corresponds to
+ the <code>PERCENTAGE</code> token in the <a
+ href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+
+ <p>Percentage values are always relative to another value, for example a
+ length. Each property that allows percentages also defines the value to
+ which the percentage refers. The value may be that of another property for
+ the same element, a property for an ancestor element, or a value of the
+ formatting context (e.g., the width of a <i>containing block</i>). When a
+ percentage value is set for a property of the <i>root</i> element and the
+ percentage is defined as referring to the inherited value of some
+ property, the resultant value is the percentage times the <i>initial
+ value</i> of that property.
+
+ <p>Properties may restrict the percentage value to some range. If the value
+ is outside the allowed range, the declaration is invalid and must be <a
+ href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
+
+ <h3 id=ltlengthgt><span class=secno>5.4. </span><length></h3>
<p>Lengths are denoted by <dfn id=ltlengthgt0><length></dfn> in the
property definitions. Lengths refer to horizontal or vertical
@@ -661,7 +727,7 @@
relative to other lengths, while <dfn id=absolute-length-units>absolute
length units</dfn> express fixed lengths.
- <h4 id=absolute-length-units-cm-mm.-in-pt-pc><span class=secno>5.3.1.
+ <h4 id=absolute-length-units-cm-mm.-in-pt-pc><span class=secno>5.4.1.
</span>Absolute length units: cm, mm. in, pt, pc</h4>
<p>Absolute length units are useful when the physical properties of the
@@ -712,7 +778,7 @@
<p>In cases where the specified length cannot be supported, user agents
must approximate it in the actual value.
- <h4 id=relative-length-units><span class=secno>5.3.2. </span>Relative
+ <h4 id=relative-length-units><span class=secno>5.4.2. </span>Relative
length units</h4>
<p>Relative units are:
@@ -770,7 +836,7 @@
"average character width" found?</span>
</table>
- <h5 id=the-em-unit><span class=secno>5.3.2.1. </span>The ‘<code
+ <h5 id=the-em-unit><span class=secno>5.4.2.1. </span>The ‘<code
class=property>em</code>’ unit</h5>
<p>The <dfn id=em title="em (unit)">em</dfn> unit is equal to the computed
@@ -811,7 +877,7 @@
</pre>
</div>
- <h5 id=the-ex-unit><span class=secno>5.3.2.2. </span>The ‘<code
+ <h5 id=the-ex-unit><span class=secno>5.4.2.2. </span>The ‘<code
class=property>ex</code>’ unit</h5>
<p>The <dfn id=ex title="x-height|ex (unit)">ex</dfn> unit is defined by
@@ -826,7 +892,7 @@
‘<code class=css>ex</code>’ units refer to the property's
<em>initial value</em>.
- <h5 id=the-px-unit><span class=secno>5.3.2.3. </span>The ‘<code
+ <h5 id=the-px-unit><span class=secno>5.4.2.3. </span>The ‘<code
class=property>px</code>’ unit</h5>
<p>The pixel unit, <dfn id=px title="pixel unit|px (pixel)">px</dfn> is
@@ -869,7 +935,7 @@
src=pixel2></p>
</div>
- <h5 id=the-rem-unit><span class=secno>5.3.2.4. </span>The ‘<code
+ <h5 id=the-rem-unit><span class=secno>5.4.2.4. </span>The ‘<code
class=property>rem</code>’ unit</h5>
<p>The <dfn id=rem title="root em|rem (unit)">rem</dfn> unit ("root em") is
@@ -881,7 +947,7 @@
‘<code class=css>rem</code>’ units refer to the property's
<em>initial value</em>.
- <h5 id=the-vw-unit><span class=secno>5.3.2.5. </span>The ‘<code
+ <h5 id=the-vw-unit><span class=secno>5.4.2.5. </span>The ‘<code
class=property>vw</code>’ unit</h5>
<p>The <dfn id=vw title="vw (unit)">vw</dfn> unit is relative to the
@@ -902,7 +968,7 @@
enlarged), lengths specified in the ‘<code
class=property>vw</code>’ unit are scaled proportionally.
- <h5 id=the-vh-unit><span class=secno>5.3.2.6. </span>The ‘<code
+ <h5 id=the-vh-unit><span class=secno>5.4.2.6. </span>The ‘<code
class=property>vh</code>’ unit</h5>
<p>The <dfn id=vh title="vh (unit)">vh</dfn> unit is relative to the
@@ -912,7 +978,7 @@
specified in the ‘<code class=property>vh</code>’ unit are
scaled proportionally.
- <h5 id=the-vm-unit><span class=secno>5.3.2.7. </span>The ‘<code
+ <h5 id=the-vm-unit><span class=secno>5.4.2.7. </span>The ‘<code
class=property>vm</code>’ unit</h5>
<p class=issue>Do we need this now that we have the min() function?
@@ -924,7 +990,7 @@
is changed, lengths specified in the ‘<code
class=property>vm</code>’ unit are scaled proportionally.
- <h4 id=the-calc-min-and-max-functions><span class=secno>5.3.3. </span>The
+ <h4 id=the-calc-min-and-max-functions><span class=secno>5.4.3. </span>The
‘<a href="#calc"><code class=property>calc</code></a>’,
‘<a href="#min"><code class=property>min</code></a>’ and
‘<a href="#max"><code class=property>max</code></a>’ functions</h4>
@@ -1031,12 +1097,12 @@
and fixed layout tables are treated as if ‘<code
class=property>auto</code>’ had been specified.
- <h3 id=ltstringgt><span class=secno>5.4. </span><string></h3>
+ <h3 id=ltstringgt><span class=secno>5.5. </span><string></h3>
<p>Strings are denoted by <dfn id=ltstringgt0><string></dfn> in the
value definitions.
- <h3 id=ltcolorgt><span class=secno>5.5. </span><color></h3>
+ <h3 id=ltcolorgt><span class=secno>5.6. </span><color></h3>
<p><em>This section is not normative. The CSS3 Color module <a
href="#CSS3COLOR" rel=biblioentry>[CSS3COLOR]<!--{{!CSS3COLOR}}--></a>
@@ -1058,49 +1124,14 @@
</pre>
</div>
- <h3 id=ltpercentagegt><span class=secno>5.6. </span><percentage></h3>
-
- <p>The format of a percentage value, denoted by <dfn id=ltpercentagegt0
- title="<percentage>::definition of"><percentage></dfn>, is a
- <a class=index href="#ltnumbergt0" id=ltnumbergt1><number></a>
- immediately followed by ‘<code class=css>%</code>’.
-
- <p>Percentage values are always relative to another value, for example a
- length. Each property that allows percentages also defines the value to
- which the percentage refers. The value may be that of another property for
- the same element, a property for an ancestor element, or a value of the
- formatting context (e.g., the width of a <em>containing block</em>). When
- a percentage value is set for a property of the <em>root</em> element and
- the percentage is defined as referring to the inherited value of some
- property, the resultant value is the percentage times the <em>initial
- value</em> of that property.
-
- <div class=example>
- <p style="display:none">Example(s):</p>
-
- <p>Since child elements (generally) inherit the <em>computed values</em>
- of their parent, in the following example, the children of the P element
- will inherit a value of 12pt for <span class=property>‘<code
- class=property>line-height</code>’</span>, not the percentage value
- (120%):</p>
-
- <pre>
-p { font-size: 10pt }
-p { line-height: 120% } /* 120% of 'font-size' */
-</pre>
- </div>
-
- <p class=issue>Do we need a "non-negative percentage", e.g. for
- "font-size"?
-
<h3 id=ltanglegt><span class=secno>5.7. </span><angle></h3>
<p>Angle values (denoted by <dfn id=ltanglegt0
title="<angle>::definition of"><angle></dfn> in the text) are
used with aural cascading style sheets.
- <p>Their format is a <a class=index href="#ltnumbergt0"
- id=ltnumbergt2><number></a> immediately followed by an angle unit
+ <p>Their format is a <a class=index href="#number-value"
+ id=ltnumbergt><number></a> immediately followed by an angle unit
identifier.
<p>Angle unit identifiers are:
@@ -1126,8 +1157,8 @@
<p>Time values are denoted by <dfn id=lttimegt0
title="<time>::definition of"><time></dfn> in the text. Their
- format is a <a class=index href="#ltnumbergt0"
- id=ltnumbergt3><number></a> immediately followed by a time unit
+ format is a <a class=index href="#number-value"
+ id=ltnumbergt0><number></a> immediately followed by a time unit
identifier.
<p>Time unit identifiers are:
@@ -1146,8 +1177,8 @@
title="<frequency>::definition of"><frequency></dfn> in the
text) are used with aural cascading style sheets.
- <p>Their format is a <a class=index href="#ltnumbergt0"
- id=ltnumbergt4><number></a> immediately followed by a frequency unit
+ <p>Their format is a <a class=index href="#number-value"
+ id=ltnumbergt1><number></a> immediately followed by a frequency unit
identifier.
<p>Frequency unit identifiers are:
@@ -1966,7 +1997,7 @@
<ul class=indexlist>
<li>absolute length units, <a href="#absolute-length-units"
- title="absolute length units"><strong>5.3.</strong></a>
+ title="absolute length units"><strong>5.4.</strong></a>
<li>actual value, <a href="#actual-value" title="actual
value"><strong>6.4.</strong></a>
@@ -1977,15 +2008,15 @@
definition of"><strong>5.7.</strong></a>
</ul>
- <li>calc(), <a href="#calc" title="calc()"><strong>5.3.3.</strong></a>
+ <li>calc(), <a href="#calc" title="calc()"><strong>5.4.3.</strong></a>
- <li>color, <a href="#color" title=color><strong>5.5.</strong></a>
+ <li>color, <a href="#color" title=color><strong>5.6.</strong></a>
<li><color>, <a href="#ltcolorgt0"
- title="<color>"><strong>5.5.</strong></a>
+ title="<color>"><strong>5.6.</strong></a>
<li>compound value, <a href="#compound-value" title="compound
- value"><strong>3.6.</strong></a>
+ value"><strong>3.4.</strong></a>
<li>computed value, <a href="#computed-value" title="computed
value"><strong>6.2.</strong></a>
@@ -1994,10 +2025,10 @@
(degrees)"><strong>5.7.</strong></a>
<li>em (unit), <a href="#em" title="em
- (unit)"><strong>5.3.2.1.</strong></a>
+ (unit)"><strong>5.4.2.1.</strong></a>
<li>ex (unit), <a href="#ex" title="ex
- (unit)"><strong>5.3.2.2.</strong></a>
+ (unit)"><strong>5.4.2.2.</strong></a>
<li><frequency>
<ul>
@@ -2009,7 +2040,7 @@
(unit)"><strong>5.13.1.</strong></a>
<li>functional notation, <a href="#functional-notation0" title="functional
- notation"><strong>3.6.</strong></a>
+ notation"><strong>3.4.</strong></a>
<li>grad (grads), <a href="#grad" title="grad
(grads)"><strong>5.7.</strong></a>
@@ -2021,72 +2052,68 @@
<li>identifier, <a href="#identifier"
- title=identifier><strong>3.4.</strong></a>
+ title=identifier><strong>3.2.</strong></a>
- <li>integer, <a href="#integer" title=integer><strong>3.1.</strong></a>
+ <li>integer, <a href="#integer" title=integer><strong>5.1.</strong></a>
- <li><integer>, <a href="#ltintegergt0"
- title="<integer>"><strong>5.1.</strong></a>
+ <li><a href="#integer-value"><code><integer></code></a>, <a
+ href="#integer-value" title="<integer>"><strong>5.1.</strong></a>
<li>kHz (kilohertz), <a href="#khz" title="kHz
(kilohertz)"><strong>5.9.</strong></a>
<li><length>, <a href="#ltlengthgt0"
- title="<length>"><strong>5.3.</strong></a>
+ title="<length>"><strong>5.4.</strong></a>
- <li>max(), <a href="#max" title="max()"><strong>5.3.3.</strong></a>
+ <li>max(), <a href="#max" title="max()"><strong>5.4.3.</strong></a>
- <li>min(), <a href="#min" title="min()"><strong>5.3.3.</strong></a>
+ <li>min(), <a href="#min" title="min()"><strong>5.4.3.</strong></a>
<li>ms (milliseconds), <a href="#ms" title="ms
(milliseconds)"><strong>5.8.</strong></a>
- <li>newline, <a href="#newline" title=newline>3.5.</a>
+ <li>newline, <a href="#newline" title=newline>3.3.</a>
- <li>number, <a href="#number" title=number><strong>3.2.</strong></a>
+ <li>number, <a href="#number" title=number><strong>5.2.</strong></a>
- <li><number>, <a href="#ltnumbergt0"
- title="<number>"><strong>5.2.</strong></a>, <a href="#ltnumbergt1"
- title="<number>">5.6.</a>, <a href="#ltnumbergt2"
- title="<number>">5.7.</a>, <a href="#ltnumbergt3"
- title="<number>">5.8.</a>, <a href="#ltnumbergt4"
- title="<number>">5.9.</a>
+ <li><number>, <a href="#ltnumbergt" title="<number>">5.7.</a>,
+ <a href="#ltnumbergt0" title="<number>">5.8.</a>, <a
+ href="#ltnumbergt1" title="<number>">5.9.</a>, <a
+ href="#number-value" title="<number>"><strong>5.2.</strong></a>
<li>number with a unit identifier, <a
href="#number-with-a-unit-identifier" title="number with a unit
- identifier"><strong>3.3.</strong></a>
+ identifier"><strong>3.1.</strong></a>
- <li><percentage>
- <ul>
- <li>definition of, <a href="#ltpercentagegt0" title="<percentage>,
- definition of"><strong>5.6.</strong></a>
- </ul>
+ <li><a href="#percentage-value"><code><percentage></code></a>, <a
+ href="#percentage-value"
+ title="<percentage>"><strong>5.3.</strong></a>
<li>pixel unit, <a href="#px" title="pixel
- unit"><strong>5.3.2.3.</strong></a>
+ unit"><strong>5.4.2.3.</strong></a>
<li>px (pixel), <a href="#px" title="px
- (pixel)"><strong>5.3.2.3.</strong></a>
+ (pixel)"><strong>5.4.2.3.</strong></a>
<li>rad (radians), <a href="#rad" title="rad
(radians)"><strong>5.7.</strong></a>
<li>reference pixel, <a href="#reference-pixel" title="reference
- pixel"><strong>5.3.2.3.</strong></a>
+ pixel"><strong>5.4.2.3.</strong></a>
<li>Relative length units, <a href="#relative-length-units0"
- title="Relative length units"><strong>5.3.</strong></a>
+ title="Relative length units"><strong>5.4.</strong></a>
<li>rem (unit), <a href="#rem" title="rem
- (unit)"><strong>5.3.2.4.</strong></a>
+ (unit)"><strong>5.4.2.4.</strong></a>
<li>Resource Identifier (URI), <a href="#uris0" title="Resource Identifier
(URI)"><strong>5.11.</strong></a>
- <li>root em, <a href="#rem" title="root em"><strong>5.3.2.4.</strong></a>
+ <li>root em, <a href="#rem" title="root em"><strong>5.4.2.4.</strong></a>
<li>simple value, <a href="#simple-value" title="simple
- value"><strong>3.6.</strong></a>
+ value"><strong>3.4.</strong></a>
<li>specified value, <a href="#specified-value" title="specified
value"><strong>6.1.</strong></a>
@@ -2094,10 +2121,10 @@
<li>s (seconds), <a href="#s" title="s
(seconds)"><strong>5.8.</strong></a>
- <li>string, <a href="#string" title=string><strong>3.5.</strong></a>
+ <li>string, <a href="#string" title=string><strong>3.3.</strong></a>
<li><string>, <a href="#ltstringgt0"
- title="<string>"><strong>5.4.</strong></a>
+ title="<string>"><strong>5.5.</strong></a>
<li><time>
<ul>
@@ -2120,14 +2147,14 @@
value"><strong>6.3.</strong></a>
<li>vh (unit), <a href="#vh" title="vh
- (unit)"><strong>5.3.2.6.</strong></a>
+ (unit)"><strong>5.4.2.6.</strong></a>
<li>vm (unit), <a href="#vm" title="vm
- (unit)"><strong>5.3.2.7.</strong></a>
+ (unit)"><strong>5.4.2.7.</strong></a>
<li>vw (unit), <a href="#vw" title="vw
- (unit)"><strong>5.3.2.5.</strong></a>
+ (unit)"><strong>5.4.2.5.</strong></a>
- <li>x-height, <a href="#ex" title=x-height><strong>5.3.2.2.</strong></a>
+ <li>x-height, <a href="#ex" title=x-height><strong>5.4.2.2.</strong></a>
</ul>
<!--end-index-->
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.src.html,v
retrieving revision 1.75
retrieving revision 1.76
diff -u -d -r1.75 -r1.76
--- Overview.src.html 10 Aug 2011 23:42:31 -0000 1.75
+++ Overview.src.html 10 Aug 2011 23:42:58 -0000 1.76
@@ -262,29 +262,6 @@
common syntactic building blocks and terms that are described in this
section.
-<h3>Integers</h3>
-
-<p>An <dfn>integer</dfn> is one or more decimal digits "0" to "9".
-Integers may be preceded by "-" or "+" to indicate the sign.
-
-<div class="example">
-<pre>
-orphans: 3
-</pre>
-</div>
-
-<h3>Numbers</h3>
-
-<p>A <dfn>number</dfn> is either an integer, or zero or more decimal
-digits followed by a dot (.) followed by one or more decimal digits.
-Numbers may be preceded by "-" or "+" to indicate the sign.
-
-<div class=example>
-<pre>
-line-height: 1.2
-</pre>
-</div>
-
<h3>Numbers with unit identifiers</h3>
<p>A <dfn>number with a unit identifier</dfn> is a number immediately followed by a unit identifier.
@@ -397,19 +374,62 @@
such as text-decoration and visibility).</p>
-<h2>Generic data types</h2>
+<h2 id="numeric-types">
+Numeric Data Types</h2>
-<h3><integer></h3>
+<h3 id="integers">
+Integers: the ''<integer>'' type</h3>
-<p>Integer values are denoted by <dfn><integer></dfn> in the value
-definitions. Properties may restrict the integer value to some range.
-If the value is outside the allowed range, the declaration is ignored.
+ <p>Integer values are denoted by
+ <dfn id="integer-value"><code><integer></code></dfn>.
+ An <dfn>integer</dfn> is one or more decimal digits ''0'' through ''9''
+ and corresponds to a subset of the <code>NUMBER</code> token in the
+ <a href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+ Integers may be immediately preceded by ''-'' or ''+'' to indicate the
+ sign.
+
+ <p>Properties may restrict the integer value to some range.
+ If the value is outside the allowed range, the declaration is invalid
+ and must be <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
-<h3><number></h3>
+<h3 id="numbers">
+Numbers: the ''<number>'' type</h3>
+
+ <p>Number values are denoted by
+ <dfn id="number-value"><code><number></code></dfn>.
+ A <dfn>number</dfn> is either an <i>integer</i>, or zero or more decimal
+ digits followed by a dot (.) followed by one or more decimal digits.
+ It corresponds to the <code>NUMBER</code> token in the
+ <a href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+ Like integers, numbers may also be immediately preceded by ''-'' or ''+''
+ to indicate the sign.
+
+ <p>Properties may restrict the number value to some range.
+ If the value is outside the allowed range, the declaration is invalid
+ and must be <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
-<p>Number values are denoted by <dfn><number></dfn> in the value
-definitions. Properties may restrict the number value to some range.
-If the value is outside the allowed range, the declaration is ignored.
+<h3 id="percentages">
+Percentages: the ''<percentage>'' type</h3>
+
+ <p>A percentage value is denoted by
+ <dfn id="percentage-value"><code><percentage></code></dfn>,
+ consists of a <i><number></i> immediately followed by a percent
+ sign ''%''. It corresponds to the <code>PERCENTAGE</code> token in the
+ <a href="http://www.w3.org/TR/CSS21/syndata.html#tokenization">grammar</a>.
+
+ <p>Percentage values are always relative to another value, for example a
+ length. Each property that allows percentages also defines the value to which
+ the percentage refers. The value may be that of another property for the same
+ element, a property for an ancestor element, or a value of the formatting
+ context (e.g., the width of a <i>containing block</i>). When a percentage
+ value is set for a property of the <i>root</i> element and the percentage
+ is defined as referring to the inherited value of some property, the
+ resultant value is the percentage times the <i>initial value</i> of that
+ property.</p>
+
+ <p>Properties may restrict the percentage value to some range.
+ If the value is outside the allowed range, the declaration is invalid
+ and must be <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
<h3><length></h3>
@@ -739,38 +759,6 @@
</div>
-<h3><percentage></h3>
-
-<p>The format of a percentage value, denoted by <dfn
-title="<percentage>::definition of"><percentage></dfn>,
-is a <span class="index"><number></span>
-immediately followed by '%'.</p>
-
-<p>Percentage values are always relative to another value, for example a
-length. Each property that allows percentages also defines the value to which
-the percentage refers. The value may be that of another property for the same
-element, a property for an ancestor element, or a value of the formatting
-context (e.g., the width of a <em>containing block</em>). When a percentage
-value is set for a property of the <em>root</em> element and the percentage
-is defined as referring to the inherited value of some property, the
-resultant value is the percentage times the <em>initial value</em> of that
-property.</p>
-
-<div class="example">
-<p style="display:none">Example(s):</p>
-
-<p>Since child elements (generally) inherit the <em>computed values</em> of
-their parent, in the following example, the children of the P element will
-inherit a value of 12pt for <span class="property">'line-height'</span>, not
-the percentage value (120%):</p>
-
-<pre>
-p { font-size: 10pt }
-p { line-height: 120% } /* 120% of 'font-size' */
-</pre>
-</div>
-
-<p class="issue">Do we need a "non-negative percentage", e.g. for "font-size"?
<h3><angle></h3>
Received on Wednesday, 10 August 2011 23:43:08 UTC