Skip to content

Commit c505749

Browse files
authored
[css-lists-3] Move "UAs can do whatever w/ list-item" text further up.
1 parent 0114eb5 commit c505749

File tree

1 file changed

+17
-14
lines changed

1 file changed

+17
-14
lines changed

css-lists-3/Overview.bs

+17-14
Original file line numberDiff line numberDiff line change
@@ -1073,13 +1073,29 @@ The Implicit ''list-item'' Counter</h3>
10731073
Specifically,
10741074
unless the 'counter-increment' property explicitly specifies
10751075
a different increment for the ''list-item'' counter,
1076-
it must be incremented by 1 on every [=list item=],
1076+
it must be incremented by the <dfn export>default list-item increment</dfn>
1077+
(which is 1 by default)
1078+
on every [=list item=],
10771079
at the same time that <a>counters</a> are normally incremented
10781080
(exactly as if the [=list item=] had ''list-item 1'' appended to their 'counter-increment' value,
10791081
including side-effects such as possibly [=instantiating=] a new [=counter=], etc).
10801082
This does not affect the [=specified value|specified=] or [=computed values=]
10811083
of 'counter-increment'.
10821084

1085+
The host language's semantics can imply different values
1086+
for this automatic counter-increment.
1087+
In that case, the [=default list-item increment=] must instead
1088+
reflect the host language's semantics.
1089+
(For example, in HTML <code highlight=html>&lt;ol reversed></code>
1090+
implies that ''list-item'' counts <em>down</em> on that list,
1091+
so the [=default list-item increment=] is -1 for <{li}>s in such lists.
1092+
See, e.g. [[#ua-stylsheet]].
1093+
1094+
<!--
1095+
See old <a href="https://github.com/w3c/csswg-drafts/issues/2464#issuecomment-375492907">WG discussions</a>
1096+
and newer <a href="https://github.com/w3c/csswg-drafts/issues/3686">issue discussion</a>.
1097+
-->
1098+
10831099
<div class="example">
10841100
Because each [=list item=] automatically increments
10851101
the ''counter-increment/list-item'' counter by 1,
@@ -1128,19 +1144,6 @@ The Implicit ''list-item'' Counter</h3>
11281144
</pre>
11291145
</div>
11301146

1131-
UAs and host languages should ensure
1132-
that the ''counter-increment/list-item'' counter values
1133-
by default
1134-
reflect the underlying numeric value dictated by host language semantics
1135-
when setting up list item styling
1136-
in their UA style sheet and presentational hint style mappings.
1137-
See, e.g. [[#ua-stylesheet]].
1138-
1139-
<!--
1140-
See old <a href="https://github.com/w3c/csswg-drafts/issues/2464#issuecomment-375492907">WG discussions</a>
1141-
and newer <a href="https://github.com/w3c/csswg-drafts/issues/3686">issue discussion</a>.
1142-
-->
1143-
11441147
<div class="example">
11451148
In the following example,
11461149
the 'content' property is used to create tiered numbering

0 commit comments

Comments
 (0)