- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 20 May 2011 19:26:11 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-lists
In directory hutz:/tmp/cvs-serv3699
Modified Files:
Overview.html Overview.src.html
Log Message:
Fix broken propdef tables, switch descriptors to descdef (instead of propdef), tweak wording of 'display: marker' definition to use terminology consistent with the rest of the spec.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.html,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -d -r1.57 -r1.58
--- Overview.html 20 May 2011 18:56:40 -0000 1.57
+++ Overview.html 20 May 2011 19:26:09 -0000 1.58
@@ -366,8 +366,8 @@
<h2 id=declaring-a-list-item><span class=secno>2. </span> Declaring a List
Item</h2>
- <p>To declare a list item, the ‘<a href="#display"><code
- class=property>display</code></a>’ property should be set to
+ <p>To declare a list item, the ‘<code
+ class=property>display</code>’ property should be set to
‘<code class=css>list-item</code>’. This, in addition to
generating a ‘<code class=css>::marker</code>’ pseudo-element
and enabling the properties described below for that element, causes that
@@ -382,9 +382,9 @@
the ‘<code class=css>counter()</code>’ and ‘<code
class=css>counters()</code>’ functions.
- <p class=issue>The CSS3 box module may define other ‘<a
- href="#display"><code class=property>display</code></a>’ values
- which generate a list marker. These should also affect the ‘<code
+ <p class=issue>The CSS3 box module may define other ‘<code
+ class=property>display</code>’ values which generate a list marker.
+ These should also affect the ‘<code
class=css>list-item</code>’ counter.
<p>Note that this new model makes the ‘<code
@@ -428,6 +428,11 @@
<td>yes
<tr>
+ <th>Percentages:
+
+ <td>N/A
+
+ <tr>
<th>Media:
<td>visual
@@ -470,8 +475,9 @@
<dd>The ‘<code class=css>::marker</code>’ pseudoelement's
default contents must be the textual contents of the list item's first
- child that is an <i title=inline-marker-candidate>inline marker
- candidate</i>, if one exists.
+ child that is an <a href="#inline-marker-candidate"><i
+ title=inline-marker-candidate>inline marker candidate</i></a>, if one
+ exists.
<dt><dfn id=none>none</dfn>
@@ -511,6 +517,11 @@
<td>yes
<tr>
+ <th>Percentages:
+
+ <td>N/A
+
+ <tr>
<th>Media:
<td>visual
@@ -574,6 +585,11 @@
<td>yes
<tr>
+ <th>Percentages:
+
+ <td>N/A
+
+ <tr>
<th>Media:
<td>visual
@@ -701,7 +717,7 @@
<tr>
<th>Initial:
- <td>N/A (shorthand property)
+ <td>see individual properties
<tr>
<th>Applies To:
@@ -710,14 +726,24 @@
list-item</code>’
<tr>
+ <th>Inherited:
+
+ <td>yes
+
+ <tr>
+ <th>Percentages:
+
+ <td>N/A
+
+ <tr>
<th>Media:
<td>visual
<tr>
- <th>Computed Value;
+ <th>Computed Value:
- <td>N/A (shorthand property)
+ <td>see individual properties
</table>
<p>The ‘<a href="#list-style"><code
@@ -833,9 +859,9 @@
<h2 id=marker-pseudoelement><span class=secno>6. </span> Markers: The
‘<code class=css>::marker</code>’ pseudo-element</h2>
- <p>Markers are created by setting an element's ‘<a
- href="#display"><code class=property>display</code></a>’ property to
- ‘<code class=css>list-item</code>’. The ‘<code
+ <p>Markers are created by setting an element's ‘<code
+ class=property>display</code>’ property to ‘<code
+ class=css>list-item</code>’. The ‘<code
class=css>list-item</code>’ display type is, in every other respect,
identical to the ‘<code class=css>block</code>’ display type.
The marker box is only created if the computed value of the ‘<code
@@ -1015,11 +1041,12 @@
href="#list-style-type"><code
class=property>list-style-type</code></a>’ is the keyword ‘<a
href="#inline"><code class=css>inline</code></a>’, and the list
- item has a child element which is an <i
- title=inline-marker-candidate>inline marker candidate</i>, the computed
- value of the ‘<code class=property>content</code>’ property
- is the textual contents of the list item's first <i
- title=inline-marker-candidate>inline marker candidate child</i>.
+ item has a child element which is an <a
+ href="#inline-marker-candidate"><i title=inline-marker-candidate>inline
+ marker candidate</i></a>, the computed value of the ‘<code
+ class=property>content</code>’ property is the textual contents of
+ the list item's first <a href="#inline-marker-candidate"><i
+ title=inline-marker-candidate>inline marker candidate child</i></a>.
<li>Otherwise, if the computed value of ‘<a
href="#list-style-type"><code
@@ -1064,7 +1091,7 @@
<h2 id=display-marker><span class=secno>7. </span> Using Content as
Markers: the ‘<code class=css>marker</code>’ value for
- ‘<a href="#display"><code class=property>display</code></a>’</h2>
+ ‘<code class=property>display</code>’</h2>
<p>In some situations, such as legal proceedings or official minutes, the
precise form that the list marker takes is a vital part of the content.
@@ -1076,38 +1103,63 @@
the marker outside of CSS, directly in the document's markup. However, the
page author may still want to style the marker in many of the ways that
are available to them when using ordinary CSS-generated markers. To
- accomodate this, a new value for the ‘<a href="#display"><code
- class=property>display</code></a>’ property is defined.
+ accomodate this, a new value for the ‘<code
+ class=property>display</code>’ property is defined.
<table class=propdef>
<tbody>
<tr>
- <th>Name:
+ <th>Property:
- <td><dfn id=display>display</dfn>
+ <td>‘<code class=property>display</code>’
<tr>
<th>New Value:
- <td>marker
+ <td>‘<code class=css>marker</code>’
+
+ <tr>
+ <th>Initial:
+
+ <td>same as CSS2.1
<tr>
<th>Applies to:
- <td>Children elements of display:list-item elements
+ <td>same as CSS2.1
+
+ <tr>
+ <th>Inherited:
+
+ <td>same as CSS2.1
+
+ <tr>
+ <th>Percentages:
+
+ <td>same as CSS2.1
+
+ <tr>
+ <th>Media:
+
+ <td>same as CSS2.1
+
+ <tr>
+ <th>Computed value:
+
+ <td>same as CSS2.1
</table>
- <p>The ‘<code class=css>marker</code>’ value for ‘<a
- href="#display"><code class=property>display</code></a>’ indicates
- that an element is a <i title=inline-marker-candidate>candidate for having
- its contents used as a list marker</i>. If the element is a child of a
- list item with ‘<code
+ <p>The <dfn id=marker>‘<code class=css>marker</code>’</dfn>
+ value for ‘<code class=property>display</code>’ indicates that
+ an element is an <dfn id=inline-marker-candidate
+ title=inline-marker-candidate>inline marker candidate</dfn>. If the
+ element is a child of a list item with ‘<code
class=css>list-style-type:inline</code>’, and none of the element's
- previous siblings are candidates, the textual content of the element (such
- as what would be returned by the .textContent property on the element in
- HTML) must be used as the default contents of the ::marker pseudoelement
- on the element's parent. Otherwise, this value must be treated identically
- to ‘<code class=css>inline-block</code>’.</p>
+ previous siblings are inline marker candidates, the textual content of the
+ element (such as what would be returned by the .textContent property on
+ the element in HTML) must be used as the default contents of the ::marker
+ pseudo-element on the element's parent. Otherwise, this value must be
+ treated identically to ‘<code class=css>inline-block</code>’.</p>
<!-- ===================================================================== -->
<h2 id=counter-style><span class=secno>8. </span> Defining Custom Counter
@@ -1162,12 +1214,12 @@
</ul>
<p>The algorithm is usually specified implicitly by a combination of the
- ‘<a href="#type"><code class=css>type</code></a>’, ‘<a
- href="#glyphs"><code class=css>glyphs</code></a>’, and ‘<a
- href="#additive-glyphs"><code class=css>additive-glyphs</code></a>’
- properties, but some counter styles instead have their algorithm
- explicitly defined in the <a href="#predefined-counters">Complex Counter
- Styles</a> section.
+ ‘<a href="#descdef-type"><code class=css>type</code></a>’,
+ ‘<a href="#descdef-glyphs"><code class=css>glyphs</code></a>’,
+ and ‘<a href="#descdef-additive-glyphs"><code
+ class=css>additive-glyphs</code></a>’ properties, but some counter
+ styles instead have their algorithm explicitly defined in the <a
+ href="#predefined-counters">Complex Counter Styles</a> section.
<p>When asked to <i title=generate-a-counter>generate a counter
representation</i> using a particular counter style for a particular
@@ -1182,15 +1234,15 @@
counter style's fallback style and the same counter value.
<li>If the counter value is negative, set the <a
- href="#negative"><var>negative</var></a> flag and run the rest of this
- algorithm with the counter value set to its absolute value instead.
+ href="#descdef-negative"><var>negative</var></a> flag and run the rest of
+ this algorithm with the counter value set to its absolute value instead.
<li>Using the counter value and the <a href="#algorithm"><i
title=counter-algorithm>counter algorithm</i></a> for the counter style,
generate an initial representation for the counter value.
- <li>If the <a href="#negative"><var>negative</var></a> flag is set, wrap
- the initial representation in the counter style's <a
+ <li>If the <a href="#descdef-negative"><var>negative</var></a> flag is
+ set, wrap the initial representation in the counter style's <a
href="#negative-sign"><i title=counter-negative>negative sign</i></a>, as
specified in the section for the <a
href="#counter-style-negative">negative descriptor</a>.
@@ -1224,7 +1276,7 @@
forward-compatible parsing requirement of CSS; parsers may ignore these
rules without error. Any descriptors that are not recognized or
implemented by a given user agent must be ignored. @counter-style rules
- require a ‘<a href="#type"><code
+ require a ‘<a href="#descdef-type"><code
class=property>type</code></a>’ descriptor; if this is missing the
@counter-style <dfn id=is>is</dfn> invalid and must be ignored. The
<i><counter-style-name></i> must be be a valid identifier and must not
@@ -1233,15 +1285,15 @@
id=is0>is</dfn> invalid and must be ignored.
<h3 id=counter-style-type><span class=secno>8.1. </span> Counter
- algorithms: the ‘<a href="#type"><code
+ algorithms: the ‘<a href="#descdef-type"><code
class=property>type</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=type>type</dfn>
+ <td><dfn id=descdef-type>type</dfn>
<tr>
<th>Value:
@@ -1255,21 +1307,22 @@
<td>N/A
</table>
- <p>The ‘<a href="#type"><code class=property>type</code></a>’
- descriptor specifies which algorithm will be used to construct the
- counter's representation based on the counter value. For example,
- ‘<code class=css>repeating</code>’ type counter styles just
- cycle through their glyphs repeatedly, while ‘<code
- class=css>numeric</code>’ type counter styles interpret their glyphs
- as digits and build their representation accordingly. The types are
- defined as follows:
+ <p>The ‘<a href="#descdef-type"><code
+ class=property>type</code></a>’ descriptor specifies which algorithm
+ will be used to construct the counter's representation based on the
+ counter value. For example, ‘<code class=css>repeating</code>’
+ type counter styles just cycle through their glyphs repeatedly, while
+ ‘<code class=css>numeric</code>’ type counter styles interpret
+ their glyphs as digits and build their representation accordingly. The
+ types are defined as follows:
<h4 id=repeating><span class=secno>8.1.1. </span> repeating</h4>
<p>If the type is ‘<code class=css>repeating</code>’, the
- ‘<a href="#glyphs"><code class=property>glyphs</code></a>’
- descriptor must contain at least one <a href="#counter-glyph"><i>counter
- glyph</i></a>. This type is defined over all counter values.
+ ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor must contain at least
+ one <a href="#counter-glyph"><i>counter glyph</i></a>. This type is
+ defined over all counter values.
<p>The ‘<code class=css>repeating</code>’ counter type cycles
repeatedly through its provided glyphs, looping back to the beginning when
@@ -1311,9 +1364,10 @@
<h4 id=numeric><span class=secno>8.1.2. </span> numeric</h4>
<p>If the type is ‘<code class=css>numeric</code>’, the
- ‘<a href="#glyphs"><code class=property>glyphs</code></a>’
- descriptor must contain at least two <a href="#counter-glyph"><i>counter
- glyph</i></a>s. This type is defined over all counter values.
+ ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor must contain at least
+ two <a href="#counter-glyph"><i>counter glyph</i></a>s. This type is
+ defined over all counter values.
<p>The ‘<code class=css>numeric</code>’ counter type cycles
interprets the list of <a href="#counter-glyph"><i>counter glyph</i></a>s
@@ -1328,9 +1382,9 @@
<p>To construct the representation, run the following algorithm. Let
<var>N</var> be the length of the list of <i>counter glyphs</i>,
<var>I</var> initially be the counter value, <var>S</var> initially be the
- empty string, <a href="#negative"><var>negative</var></a> be a boolean
- flag that is initially false, and <var>glyph(n)</var> be the nth <a
- href="#counter-glyph"><i>counter glyph</i></a> in the list of <a
+ empty string, <a href="#descdef-negative"><var>negative</var></a> be a
+ boolean flag that is initially false, and <var>glyph(n)</var> be the nth
+ <a href="#counter-glyph"><i>counter glyph</i></a> in the list of <a
href="#counter-glyph"><i>counter glyph</i></a>s (0-indexed).
<ol>
@@ -1374,9 +1428,10 @@
<h4 id=alphabetic><span class=secno>8.1.3. </span> alphabetic</h4>
<p>If the type is ‘<code class=css>alphabetic</code>’, the
- ‘<a href="#glyphs"><code class=property>glyphs</code></a>’
- descriptor must contain at least two <a href="#counter-glyph"><i>counter
- glyph</i></a>s. This type is defined only over positive counter values.
+ ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor must contain at least
+ two <a href="#counter-glyph"><i>counter glyph</i></a>s. This type is
+ defined only over positive counter values.
<p>The ‘<code class=css>alphabetic</code>’ counter type
interprets the list of <i>counter glyphs</i> as digits to an
@@ -1480,9 +1535,10 @@
<h4 id=symbolic><span class=secno>8.1.4. </span> symbolic</h4>
<p>If the type is ‘<code class=css>symbolic</code>’, the
- ‘<a href="#glyphs"><code class=property>glyphs</code></a>’
- descriptor must contain at least one <a href="#counter-glyph"><i>counter
- glyph</i></a>. This type is defined only over positive counter values.
+ ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor must contain at least
+ one <a href="#counter-glyph"><i>counter glyph</i></a>. This type is
+ defined only over positive counter values.
<p>The ‘<code class=css>symbolic</code>’ counter type cycles
repeatedly through its provided glyphs, doubling, tripling, etc. the
@@ -1533,12 +1589,13 @@
<h4 id=non-repeating><span class=secno>8.1.5. </span> non-repeating</h4>
<p>If the type is ‘<code class=css>non-repeating</code>’, the
- ‘<a href="#glyphs"><code class=property>glyphs</code></a>’
- descriptor must contain at least one <a href="#counter-glyph"><i>counter
- glyph</i></a>. This type is defined over counter values in a finite range,
- starting with the <a href="#first-glyph-value"><i>first glyph
- value</i></a> and having a length equal to the length of the list of <a
- href="#counter-glyph"><i>counter glyph</i></a>s.
+ ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor must contain at least
+ one <a href="#counter-glyph"><i>counter glyph</i></a>. This type is
+ defined over counter values in a finite range, starting with the <a
+ href="#first-glyph-value"><i>first glyph value</i></a> and having a length
+ equal to the length of the list of <a href="#counter-glyph"><i>counter
+ glyph</i></a>s.
<p>The ‘<code class=css>non-repeating</code>’ counter type is
for representing counter styles that only have a finite number of
@@ -1584,7 +1641,7 @@
<h4 id=additive><span class=secno>8.1.6. </span> additive</h4>
<p>If the type is ‘<code class=css>additive</code>’, the
- ‘<a href="#additive-glyphs"><code
+ ‘<a href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptor must contain
at least one <a href="#additive-tuple"><i>additive tuple</i></a>. This
type is nominally defined over all positive counter values (see algorithm,
@@ -1669,8 +1726,8 @@
<p>If a @counter-style <dfn id=uses>uses</dfn> the ‘<code
class=css>override</code>’ type, it must not contain a ‘<a
- href="#glyphs"><code class=property>glyphs</code></a>’ or ‘<a
- href="#additive-glyphs"><code
+ href="#descdef-glyphs"><code class=property>glyphs</code></a>’ or
+ ‘<a href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptor; otherwise it
is invalid and must be ignored. If the specified counter style name isn't
the name of any currently-defined counter style, it must be treated as if
@@ -1678,15 +1735,15 @@
class=css>decimal</code></a>’ counter style.
<h3 id=counter-style-negative><span class=secno>8.2. </span> Formatting
- negative values: the ‘<a href="#negative"><code
+ negative values: the ‘<a href="#descdef-negative"><code
class=property>negative</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=negative>negative</dfn>
+ <td><dfn id=descdef-negative>negative</dfn>
<tr>
<th>Value:
@@ -1699,7 +1756,7 @@
<td>"\2D" ("-" hyphen-minus)
</table>
- <p>The ‘<a href="#negative"><code
+ <p>The ‘<a href="#descdef-negative"><code
class=property>negative</code></a>’ descriptor defines how to alter
the representation when the counter value is negative. Not all counter
types can render negative numbers.
@@ -1709,22 +1766,22 @@
appended to the representation when the counter value is negative.
<div class=example>
- <p>For example, specifying ‘<a href="#negative"><code
+ <p>For example, specifying ‘<a href="#descdef-negative"><code
class=css>negative: "(" ")";</code></a>’ will make negative values
be wrapped in parentheses, which is sometimes used in financial contexts,
like "(2) (1) 0 1 2 3...".</p>
</div>
<h3 id=counter-style-prefix><span class=secno>8.3. </span> Symbols before
- the marker: the ‘<a href="#prefix0"><code
+ the marker: the ‘<a href="#descdef-prefix"><code
class=property>prefix</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=prefix0>prefix</dfn>
+ <td><dfn id=descdef-prefix>prefix</dfn>
<tr>
<th>Value:
@@ -1737,7 +1794,7 @@
<td>"" (the empty string)
</table>
- <p>The ‘<a href="#prefix0"><code
+ <p>The ‘<a href="#descdef-prefix"><code
class=property>prefix</code></a>’ descripter specifies a string that
is prepended to the marker representation. Prefixes are only added by the
algorithm for constructing the default contents of the ::marker
@@ -1746,15 +1803,15 @@
after negative signs.
<h3 id=counter-style-suffix><span class=secno>8.4. </span> Symbols after
- the marker: the ‘<a href="#suffix0"><code
+ the marker: the ‘<a href="#descdef-suffix"><code
class=property>suffix</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=suffix0>suffix</dfn>
+ <td><dfn id=descdef-suffix>suffix</dfn>
<tr>
<th>Value:
@@ -1767,7 +1824,7 @@
<td>"\2E" ("." full stop)
</table>
- <p>The ‘<a href="#suffix0"><code
+ <p>The ‘<a href="#descdef-suffix"><code
class=property>suffix</code></a>’ descripter specifies a string that
is appended to the marker representation. Suffixes are only added by the
algorithm for constructing the default contents of the ::marker
@@ -1776,15 +1833,15 @@
after negative signs.
<h3 id=counter-style-range><span class=secno>8.5. </span> Limiting the
- counter scope: the ‘<a href="#range"><code
+ counter scope: the ‘<a href="#descdef-range"><code
class=property>range</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=range>range</dfn>
+ <td><dfn id=descdef-range>range</dfn>
<tr>
<th>Value:
@@ -1797,10 +1854,11 @@
<td>infinite infinite
</table>
- <p>The ‘<a href="#range"><code class=property>range</code></a>’
- descriptor defines the range over which the counter style is defined. If a
- counter style is used to represent a counter value outside of its range,
- the counter style instead drops down to its fallback counter style.
+ <p>The ‘<a href="#descdef-range"><code
+ class=property>range</code></a>’ descriptor defines the range over
+ which the counter style is defined. If a counter style is used to
+ represent a counter value outside of its range, the counter style instead
+ drops down to its fallback counter style.
<p>The first value represents the lower bound of the range (with
‘<code class=property>infinite</code>’ representing negative
@@ -1812,27 +1870,27 @@
<p>Some counter style types have their own implicit ranges, specified above
in the individual descriptions for each type. The explicit range given by
- the ‘<a href="#range"><code class=css>range</code></a>’ descriptor
- applies at the same time as the implicit range given by the ‘<a
- href="#type"><code class=css>type</code></a>’ descriptor - if the
- counter value is less than either lower bound, or greater than either
- upper bound, the fallback style must instead be used to generate the
- representation.
+ the ‘<a href="#descdef-range"><code class=css>range</code></a>’
+ descriptor applies at the same time as the implicit range given by the
+ ‘<a href="#descdef-type"><code class=css>type</code></a>’ descriptor -
+ if the counter value is less than either lower bound, or greater than
+ either upper bound, the fallback style must instead be used to generate
+ the representation.
<p class=issue>There's also an implicit range coming from implementation
limits. Should we require UAs to support all values in a signed 2-byte
int, or a signed 4-byte int?
<h3 id=counter-style-fallback><span class=secno>8.6. </span> Defining
- fallback: the ‘<a href="#fallback"><code
+ fallback: the ‘<a href="#descdef-fallback"><code
class=property>fallback</code></a>’ descriptor</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=fallback>fallback</dfn>
+ <td><dfn id=descdef-fallback>fallback</dfn>
<tr>
<th>Value:
@@ -1845,7 +1903,7 @@
<td>decimal
</table>
- <p>The ‘<a href="#fallback"><code
+ <p>The ‘<a href="#descdef-fallback"><code
class=property>fallback</code></a>’ descriptor specifies a fallback
counter style to be used when the current counter style can't create a
representation for a given counter value. For example, if a counter style
@@ -1854,10 +1912,10 @@
fallback counter style (or possibly the fallback style's fallback style,
if the fallback style can't represent that value, etc.).
- <p>If the value of the ‘<a href="#fallback"><code
+ <p>If the value of the ‘<a href="#descdef-fallback"><code
class=property>fallback</code></a>’ descriptor isn't the name of any
currently-defined counter style, the used value of the ‘<a
- href="#fallback"><code class=property>fallback</code></a>’
+ href="#descdef-fallback"><code class=property>fallback</code></a>’
descriptor is ‘<a href="#decimal"><code
class=css>decimal</code></a>’ instead. Similarly, while following
fallbacks to find a counter style that can render the given counter value,
@@ -1878,17 +1936,17 @@
graphs, that would probably be acceptable.</span>
<h3 id=counter-style-glyphs><span class=secno>8.7. </span> Marker
- characters: the ‘<a href="#glyphs"><code
+ characters: the ‘<a href="#descdef-glyphs"><code
class=property>glyphs</code></a>’ and ‘<a
- href="#additive-glyphs"><code
+ href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptors</h3>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=glyphs>glyphs</dfn>
+ <td><dfn id=descdef-glyphs>glyphs</dfn>
<tr>
<th>Value:
@@ -1901,12 +1959,12 @@
<td>N/A
</table>
- <table class=propdef>
+ <table class=descdef>
<tbody>
<tr>
<th>Name:
- <td><dfn id=additive-glyphs>additive-glyphs</dfn>
+ <td><dfn id=descdef-additive-glyphs>additive-glyphs</dfn>
<tr>
<th>Value:
@@ -1919,36 +1977,37 @@
<td>N/A
</table>
- <p>The ‘<a href="#glyphs"><code
+ <p>The ‘<a href="#descdef-glyphs"><code
class=property>glyphs</code></a>’ and ‘<a
- href="#additive-glyphs"><code
+ href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptors specify the
characters used by the marker-construction algorithm specified by the
- ‘<a href="#type"><code class=property>type</code></a>’
- descriptor. The ‘<a href="#glyphs"><code
+ ‘<a href="#descdef-type"><code class=property>type</code></a>’
+ descriptor. The ‘<a href="#descdef-glyphs"><code
class=property>glyphs</code></a>’ descriptor must be specified if
the counter type is ‘<code class=css>repeating</code>’,
‘<code class=css>numeric</code>’, ‘<code
class=css>alphabetic</code>’, ‘<code
class=css>symbolic</code>’, or ‘<code
class=css>non-repeating</code>’, and the ‘<a
- href="#additive-glyphs"><code
+ href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptor must be
specified if the counter type is ‘<code
class=css>additive</code>’; otherwise, the @counter-style <dfn
id=is1>is</dfn> invalid and must be ignored.
- <p>Some counter styles specify that the ‘<a href="#glyphs"><code
- class=property>glyphs</code></a>’ descriptor must have at least two
- entries. If the counter's style is such a type, and the ‘<a
- href="#glyphs"><code class=property>glyphs</code></a>’ descriptor
- has only a single entry, the counter style is invalid and must be ignored.
+ <p>Some counter styles specify that the ‘<a
+ href="#descdef-glyphs"><code class=property>glyphs</code></a>’
+ descriptor must have at least two entries. If the counter's style is such
+ a type, and the ‘<a href="#descdef-glyphs"><code
+ class=property>glyphs</code></a>’ descriptor has only a single
+ entry, the counter style is invalid and must be ignored.
- <p>Each entry in the ‘<a href="#glyphs"><code
+ <p>Each entry in the ‘<a href="#descdef-glyphs"><code
class=property>glyphs</code></a>’ descriptor's value defines a <dfn
id=counter-glyph>counter glyph</dfn>, which is interpreted differently
based on the counter style's type. Each entry in the ‘<a
- href="#additive-glyphs"><code
+ href="#descdef-additive-glyphs"><code
class=property>additive-glyphs</code></a>’ descriptor's value
defines an <dfn id=additive-tuple>additive tuple</dfn>, which consists of
a <a href="#counter-glyph"><i>counter glyph</i></a> and a non-negative
@@ -4229,47 +4288,21 @@
<tbody>
<tr valign=baseline>
- <td><a class=property href="#additive-glyphs">additive-glyphs</a>
-
- <td>[ <integer> && [ <string> | <image> ] ]+
-
- <td>N/A
-
- <tr valign=baseline>
- <td><a class=property href="#display">display</a>
-
- <td>marker
-
- <td>Children elements of display:list-item elements
-
- <tr valign=baseline>
- <td><a class=property href="#fallback">fallback</a>
-
- <td><counter-style-name>
-
- <td>decimal
-
- <tr valign=baseline>
- <td><a class=property href="#glyphs">glyphs</a>
-
- <td>[ <string> | <image> ]+
-
- <td>N/A
-
- <tr valign=baseline>
<td><a class=property href="#list-style">list-style</a>
<td><‘list-style-type’> ||
<‘list-style-position’> ||
<‘list-style-image’>
- <td>N/A (shorthand property)
+ <td>see individual properties
<td>all elements with ‘display: list-item’
- <td>visual
+ <td>yes
- <td>N/A (shorthand property)
+ <td>N/A
+
+ <td>visual
<tr valign=baseline>
<td><a class=property href="#list-style-image">list-style-image</a>
@@ -4282,9 +4315,9 @@
<td>yes
- <td>visual
+ <td>N/A
- <td>specified value
+ <td>visual
<tr valign=baseline>
<td><a class=property
@@ -4298,9 +4331,9 @@
<td>yes
- <td>visual
+ <td>N/A
- <td>specified value
+ <td>visual
<tr valign=baseline>
<td><a class=property href="#list-style-type">list-style-type</a>
@@ -4313,45 +4346,24 @@
<td>yes
- <td>visual
-
- <td>specified value
-
- <tr valign=baseline>
- <td><a class=property href="#negative">negative</a>
-
- <td><string> <string>?
-
- <td>"\2D" ("-" hyphen-minus)
-
- <tr valign=baseline>
- <td><a class=property href="#prefix0">prefix</a>
-
- <td><string>
+ <td>N/A
- <td>"" (the empty string)
+ <td>visual
<tr valign=baseline>
- <td><a class=property href="#range">range</a>
-
- <td>[ <integer> | infinite ]{2}
-
- <td>infinite infinite
+ <td><span class=property>‘display’</span>
- <tr valign=baseline>
- <td><a class=property href="#suffix0">suffix</a>
+ <td>‘marker’
- <td><string>
+ <td>same as CSS2.1
- <td>"\2E" ("." full stop)
+ <td>same as CSS2.1
- <tr valign=baseline>
- <td><a class=property href="#type">type</a>
+ <td>same as CSS2.1
- <td>repeating | numeric | alphabetic | symbolic | additive |
- [non-repeating <integer>?] | [ override <counter-style-name> ]
+ <td>same as CSS2.1
- <td>N/A
+ <td>same as CSS2.1
</table>
<!--end-properties-->
@@ -4359,7 +4371,7 @@
<!--begin-index-->
<ul class=indexlist>
- <li>additive-glyphs, <a href="#additive-glyphs"
+ <li>additive-glyphs, <a href="#descdef-additive-glyphs"
title=additive-glyphs><strong>8.7.</strong></a>
<li>additive tuple, <a href="#additive-tuple" title="additive
@@ -4479,8 +4491,6 @@
<li>disc, <a href="#disc" title=disc><strong>9.1.</strong></a>
- <li>display, <a href="#display" title=display><strong>7.</strong></a>
-
<li>dizi, <a href="#dizi" title=dizi><strong>9.3.</strong></a>
<li>dotted-decimal, <a href="#dotted-decimal"
@@ -4492,8 +4502,8 @@
<li>eastern-nagari, <a href="#eastern-nagari"
title=eastern-nagari><strong>9.2.</strong></a>
- <li>fallback, <a href="#fallback" title=fallback><strong>8.6.</strong></a>
-
+ <li>fallback, <a href="#descdef-fallback"
+ title=fallback><strong>8.6.</strong></a>
<li>filled-circled-decimal, <a href="#filled-circled-decimal"
title=filled-circled-decimal><strong>9.5.</strong></a>
@@ -4527,7 +4537,8 @@
<li>georgian, <a href="#georgian" title=georgian><strong>9.6.</strong></a>
- <li>glyphs, <a href="#glyphs" title=glyphs><strong>8.7.</strong></a>
+ <li>glyphs, <a href="#descdef-glyphs"
+ title=glyphs><strong>8.7.</strong></a>
<li>go, <a href="#go" title=go><strong>8.1.3.</strong></a>
@@ -4559,6 +4570,9 @@
<li>inline, <a href="#inline" title=inline><strong>3.</strong></a>
+ <li>inline-marker-candidate, <a href="#inline-marker-candidate"
+ title=inline-marker-candidate><strong>7.</strong></a>
+
<li>inside, <a href="#inside" title=inside><strong>4.</strong></a>
<li>is, <a href="#is" title=is><strong>8.</strong></a>, <a href="#is0"
@@ -4682,6 +4696,9 @@
<li>marathi, <a href="#marathi" title=marathi><strong>9.2.</strong></a>
+ <li>‘<code class=css>marker</code>’, <a href="#marker"
+ title="''marker''"><strong>7.</strong></a>
+
<li>meen, <a href="#meen" title=meen><strong>9.3.</strong></a>
<li>mongolian, <a href="#mongolian"
@@ -4689,8 +4706,8 @@
<li>myanmar, <a href="#myanmar" title=myanmar><strong>9.2.</strong></a>
- <li>negative, <a href="#negative" title=negative><strong>8.2.</strong></a>
-
+ <li>negative, <a href="#descdef-negative"
+ title=negative><strong>8.2.</strong></a>
<li>new-base-, <a href="#new-base-"
title=new-base-><strong>9.2.</strong></a>
@@ -4727,9 +4744,10 @@
<li>persian-alphabetic, <a href="#persian-alphabetic"
title=persian-alphabetic><strong>9.5.</strong></a>
- <li>prefix, <a href="#prefix0" title=prefix><strong>8.3.</strong></a>
+ <li>prefix, <a href="#descdef-prefix"
+ title=prefix><strong>8.3.</strong></a>
- <li>range, <a href="#range" title=range><strong>8.5.</strong></a>
+ <li>range, <a href="#descdef-range" title=range><strong>8.5.</strong></a>
<li>rule, <a href="#rule" title=rule><strong>8.</strong></a>, <a
href="#rule0" title=rule><strong>8.</strong></a>, <a href="#rule1"
@@ -4764,7 +4782,8 @@
<li><string>, <a href="#ltstring"
title="<string>"><strong>3.</strong></a>
- <li>suffix, <a href="#suffix0" title=suffix><strong>8.4.</strong></a>
+ <li>suffix, <a href="#descdef-suffix"
+ title=suffix><strong>8.4.</strong></a>
<li>super-decimal, <a href="#super-decimal"
title=super-decimal><strong>9.2.</strong></a>
@@ -4797,7 +4816,7 @@
<li>trinary, <a href="#trinary" title=trinary><strong>8.1.2.</strong></a>
- <li>type, <a href="#type" title=type><strong>8.1.</strong></a>
+ <li>type, <a href="#descdef-type" title=type><strong>8.1.</strong></a>
<li>unary, <a href="#unary" title=unary><strong>8.1.4.</strong></a>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v
retrieving revision 1.100
retrieving revision 1.101
diff -u -d -r1.100 -r1.101
--- Overview.src.html 20 May 2011 18:56:40 -0000 1.100
+++ Overview.src.html 20 May 2011 19:26:09 -0000 1.101
@@ -180,6 +180,9 @@
<th>Inherited:
<td>yes
<tr>
+ <th>Percentages:
+ <td>N/A
+ <tr>
<th>Media:
<td>visual
<tr>
@@ -238,6 +241,9 @@
<th>Inherited:
<td>yes
<tr>
+ <th>Percentages:
+ <td>N/A
+ <tr>
<th>Media:
<td>visual
<tr>
@@ -280,6 +286,9 @@
<th>Inherited:
<td>yes
<tr>
+ <th>Percentages:
+ <td>N/A
+ <tr>
<th>Media:
<td>visual
<tr>
@@ -374,16 +383,22 @@
<td><'list-style-type'> || <'list-style-position'> || <'list-style-image'>
<tr>
<th>Initial:
- <td>N/A (shorthand property)
+ <td>see individual properties
<tr>
<th>Applies To:
<td>all elements with ''display: list-item''
<tr>
+ <th>Inherited:
+ <td>yes
+ <tr>
+ <th>Percentages:
+ <td>N/A
+ <tr>
<th>Media:
<td>visual
<tr>
- <th>Computed Value;
- <td>N/A (shorthand property)
+ <th>Computed Value:
+ <td>see individual properties
</table>
<p>The 'list-style' property is a shorthand notation for setting the
@@ -694,25 +709,42 @@
CSS-generated markers. To accomodate this, a new value for the 'display'
property is defined.</p>
- <table class='propdef'>
- <tr>
- <th>Name:
- <td><dfn>display</dfn>
- <tr>
- <th>New Value:
- <td>marker
- <tr>
- <th>Applies to:
- <td>Children elements of display:list-item elements
+ <table class="propdef">
+ <tbody>
+ <tr>
+ <th>Property:
+ <td>'display'
+ <tr>
+ <th>New Value:
+ <td>''marker''
+ <tr>
+ <th>Initial:
+ <td>same as CSS2.1
+ <tr>
+ <th>Applies to:
+ <td>same as CSS2.1
+ <tr>
+ <th>Inherited:
+ <td>same as CSS2.1
+ <tr>
+ <th>Percentages:
+ <td>same as CSS2.1
+ <tr>
+ <th>Media:
+ <td>same as CSS2.1
+ <tr>
+ <th>Computed value:
+ <td>same as CSS2.1
+ </tbody>
</table>
- <p>The ''marker'' value for 'display' indicates that an element is a
- <i title="inline-marker-candidate">candidate for having its contents used
- as a list marker</i>. If the element is a child of a list item with
- ''list-style-type:inline'', and none of the element's previous siblings are
- candidates, the textual content of the element (such as what would be returned
+ <p>The <dfn>''marker''</dfn> value for 'display' indicates that an element
+ is an <dfn title="inline-marker-candidate">inline marker candidate</dfn>.
+ If the element is a child of a list item with ''list-style-type:inline'',
+ and none of the element's previous siblings are inline marker candidates,
+ the textual content of the element (such as what would be returned
by the .textContent property on the element in HTML) must be used as the
- default contents of the ::marker pseudoelement on the element's parent.
+ default contents of the ::marker pseudo-element on the element's parent.
Otherwise, this value must be treated identically to ''inline-block''.</p>
<!-- ===================================================================== -->
@@ -818,10 +850,10 @@
<h3 id='counter-style-type'>
Counter algorithms: the 'type' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>type</dfn>
+ <td><dfn id="descdef-type">type</dfn>
<tr>
<th>Value:
<td>repeating | numeric | alphabetic | symbolic | additive
@@ -1228,10 +1260,10 @@
<h3 id='counter-style-negative'>
Formatting negative values: the 'negative' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>negative</dfn></td>
+ <td><dfn id="descdef-negative">negative</dfn></td>
<tr>
<th>Value:
<td><string> <string>?
@@ -1258,10 +1290,10 @@
<h3 id='counter-style-prefix'>
Symbols before the marker: the 'prefix' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>prefix</dfn>
+ <td><dfn id="descdef-prefix">prefix</dfn>
<tr>
<th>Value:
<td><string>
@@ -1280,10 +1312,10 @@
<h3 id='counter-style-suffix'>
Symbols after the marker: the 'suffix' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>suffix</dfn>
+ <td><dfn id="descdef-suffix">suffix</dfn>
<tr>
<th>Value:
<td><string>
@@ -1302,10 +1334,10 @@
<h3 id='counter-style-range'>
Limiting the counter scope: the 'range' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>range</dfn>
+ <td><dfn id="descdef-range">range</dfn>
<tr>
<th>Value:
<td>[ <integer> | infinite ]{2}
@@ -1341,10 +1373,10 @@
<h3 id='counter-style-fallback'>
Defining fallback: the 'fallback' descriptor</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>fallback</dfn>
+ <td><dfn id="descdef-fallback">fallback</dfn>
<tr>
<th>Value:
<td><counter-style-name>
@@ -1382,10 +1414,10 @@
<h3 id='counter-style-glyphs'>
Marker characters: the 'glyphs' and 'additive-glyphs' descriptors</h3>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>glyphs</dfn>
+ <td><dfn id="descdef-glyphs">glyphs</dfn>
<tr>
<th>Value:
<td>[ <string> | <image> ]+
@@ -1394,10 +1426,10 @@
<td>N/A
</table>
- <table class='propdef'>
+ <table class='descdef'>
<tr>
<th>Name:
- <td><dfn>additive-glyphs</dfn>
+ <td><dfn id="descdef-additive-glyphs">additive-glyphs</dfn>
<tr>
<th>Value:
<td>[ <integer> && [ <string> | <image> ] ]+
Received on Friday, 20 May 2011 19:26:17 UTC