Skip to content

Commit 16f9106

Browse files
committed
[css-lists-3] Clarify which properties apply to ::marker vs contents of ::marker. #4568
1 parent a1caf77 commit 16f9106

File tree

1 file changed

+34
-6
lines changed

1 file changed

+34
-6
lines changed

css-lists-3/Overview.bs

+34-6
Original file line numberDiff line numberDiff line change
@@ -207,23 +207,41 @@ The ''::marker'' Pseudo-Element</h3>
207207
<h4 id='marker-properties'>
208208
Properties Applying to ''::marker''</h4>
209209

210-
The following CSS properties (and only these properties)
211-
apply to a ''::marker'' pseudo-element:
210+
All properties can be set on a ''::marker'' pseudo-element
211+
and will have a [=computed value=];
212+
however,
213+
only the following CSS properties
214+
actually apply to a [=marker box=]:
212215

213216
<ul>
214-
<li>all font properties (see [[CSS-FONTS-3]] and its successors)
215-
<li>the 'white-space' property (see [[CSS-TEXT-3]])
216-
<li>the 'color' property (see [[CSS-COLOR-3]])
217217
<li>the 'text-combine-upright', 'unicode-bidi', and 'direction' properties (see [[CSS-WRITING-MODES-3]])
218218
<li>the 'content' property (see [[#content-property]], below)
219219
<li>all animation and transition properties (see [[CSS-ANIMATIONS-1]] and [[CSS-TRANSITIONS-1]])
220220
</ul>
221221

222222
<p class="note">
223223
It is expected that future specifications will extend this list of properties;
224-
however at the moment marker box layout is not fully defined,
224+
however at the moment outside marker box layout is not fully defined,
225225
so only these properties are allowed.
226226

227+
Other properties must not have an effect on the [=marker box=]
228+
when set in the [=author origin=] of the [=cascade=].
229+
UAs may either treat such properties as not applying,
230+
or enforce their value by setting a [=user-agent origin=] ''!important'' rule.
231+
However, inheritable properties that apply to text
232+
can be set on the ''::marker'' pseudo-element:
233+
these will inherit to and take effect on its text contents.
234+
235+
<div class=example>
236+
Examples of properties that apply to text,
237+
and therefore to the contents of ''::marker'' when declared on ''::marker'':
238+
<ul>
239+
<li>'white-space', 'text-transform', 'letter-spacing' (see [[CSS-TEXT-3]])
240+
<li>all font properties (see [[CSS-FONTS-3]] and its successors)
241+
<li>the 'color' property (see [[CSS-COLOR-3]])
242+
</ul>
243+
</div>
244+
227245
UAs must add the following rule to their default style sheet:
228246
<pre>
229247
::marker, ::before::marker, ::after::marker {
@@ -1544,6 +1562,16 @@ Acknowledgments</h2>
15441562

15451563
This section documents the changes since previous publications.
15461564

1565+
<h3 id="changes-20200709">Changes since the 9 July 2020 WD</h3>
1566+
1567+
<ul>
1568+
<li>Clarified properties that apply to ''::marker'' boxes
1569+
vs. to the contents of ''::marker'' boxes.
1570+
(<a href="https://github.com/w3c/csswg-drafts/issues/4568">Issue 4568</a>)
1571+
<li>Added ''text-transform: none'' to the UA default style sheet for ''::marker''.
1572+
(<a href="https://github.com/w3c/csswg-drafts/issues/4206">Issue 4206</a>)
1573+
</ul>
1574+
15471575
<h3 id="changes-20190817">Changes since the 17 August 2019 WD</h3>
15481576

15491577
<ul>

0 commit comments

Comments
 (0)