FFFF [css3-lists] Rewrote the marker-attachment section, renamed it to mar… · w3c/csswg-drafts@b6508ca · GitHub
Skip to content

Commit b6508ca

Browse files
tabatkinstabatkins
committed
[css3-lists] Rewrote the marker-attachment section, renamed it to marker-side per f2f feedback.
1 parent ad49297 commit b6508ca

2 files changed

Lines changed: 82 additions & 62 deletions

File tree

‎css3-lists/Overview.html‎

Lines changed: 47 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,12 @@
2525

2626
<h1>CSS Lists and Counters Module Level 3</h1>
2727

28-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 August 2012</h2>
28+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 24 August 2012</h2>
2929

3030
<dl>
3131
<dt>This version:
3232

33-
<dd><!--<a href="http://www.w3.org/TR/2012/WD-css3-lists-20120820">http://www.w3.org/TR/2012/WD-css3-lists-20120820</a>-->
33+
<dd><!--<a href="http://www.w3.org/TR/2012/WD-css3-lists-20120824">http://www.w3.org/TR/2012/WD-css3-lists-20120824</a>-->
3434
<a
3535
href="http://dev.w3.org/csswg/css3-lists/">http://dev.w3.org/csswg/css3-lists/</a>
3636

@@ -172,8 +172,8 @@ <h2 class="no-num no-toc" id=contents> Table of contents</h2>
172172
‘<code class=css>marker</code>’ value for ‘<code
173173
class=property>position</code>’</a>
174174

175-
<li><a href="#marker-attachment"><span class=secno>7.2. </span> The
176-
‘<code class=property>marker-attachment</code>’ property</a>
175+
<li><a href="#marker-side"><span class=secno>7.2. </span> The ‘<code
176+
class=property>marker-side</code>’ property</a>
177177
</ul>
178178

179179
<li><a href="#counter"><span class=secno>8. </span> Automatic Counters and
@@ -1282,16 +1282,16 @@ <h3 id=position-marker><span class=secno>7.1. </span> The ‘<code
12821282

12831283
<dd>
12841284
<p> If the <a href="#ancestor-list-item"><i>ancestor list item</i></a>
1285-
has ‘<code class=css>marker-attachment:list-item</code>’, the <a
1285+
has ‘<code class=css>marker-side:list-item</code>’, the <a
12861286
href="#marker-positioning-reference-element"><i>marker positioning
12871287
reference element</i></a> is the <a
12881288
href="#ancestor-list-item"><i>ancestor list item</i></a>.
12891289

12901290
<p> Otherwise, if the <a href="#ancestor-list-item"><i>ancestor list
1291-
item</i></a> has ‘<code
1292-
class=css>marker-attachment:list-container</code>’ and has a parent
1293-
element, the <a href="#marker-positioning-reference-element"><i>marker
1294-
positioning reference element</i></a> is the <a
1291+
item</i></a> has ‘<code class=css>marker-side:list-container</code>’
1292+
and has a parent element, the <a
1293+
href="#marker-positioning-reference-element"><i>marker positioning
1294+
reference element</i></a> is the <a
12951295
href="#ancestor-list-item"><i>ancestor list item's</i></a> parent.
12961296

12971297
<p> Otherwise, the <a
@@ -1331,8 +1331,8 @@ <h3 id=position-marker><span class=secno>7.1. </span> The ‘<code
13311331

13321332
<p class=note> Note: The purpose of this somewhat convoluted definition is
13331333
to position the marker flush against its list item, and then when
1334-
"marker-attachment:list-container", keep all the markers for a given list
1335-
on the same side of their list items even in mixed-direction text, so that
1334+
"marker-side:list-container", keep all the markers for a given list on the
1335+
same side of their list items even in mixed-direction text, so that
13361336
authors can specify padding on only one side of the list container and
13371337
still ensure their markers are visible. And on top of all that, do
13381338
something sane in the face of potentially differing writing-modes on the
@@ -1415,30 +1415,29 @@ <h3 id=position-marker><span class=secno>7.1. </span> The ‘<code
14151415
confident that the reference will always be resolvable.
14161416
</div>
14171417

1418-
<h3 id=marker-attachment><span class=secno>7.2. </span> The ‘<a
1419-
href="#marker-attachment0"><code
1420-
class=property>marker-attachment</code></a>’ property</h3>
1418+
<h3 id=marker-side><span class=secno>7.2. </span> The ‘<a
1419+
href="#marker-side0"><code class=property>marker-side</code></a>’
1420+
property</h3>
14211421

1422-
<p>By default, elements or ‘<code class=css>::marker</code>’
1422+
<p> By default, elements or ‘<code class=css>::marker</code>’
14231423
pseudo-elements with ‘<code class=css>position:marker</code>’ position
14241424
themselves according to their list item's directionality. However, if the
14251425
list item is grouped with several other list items which may have
14261426
different directionality (for example, multiple &lt;li>s with different
14271427
"dir" attributes in an &lt;ol> in HTML), it is sometimes more useful to
14281428
have all the markers line up on one side, so the author can specify a
14291429
single "gutter" on that side and be assured that all the markers will lie
1430-
in that gutter and be visible. The ‘<a href="#marker-attachment0"><code
1431-
class=property>marker-attachment</code></a>’ property defined in this
1432-
section allows an author to control this, switching list items to
1433-
positioning their markers based off the list container's directionality
1434-
instead.
1430+
in that gutter and be visible. The ‘<a href="#marker-side0"><code
1431+
class=property>marker-side</code></a>’ property defined in this section
1432+
allows an author to control this, switching list items to positioning
1433+
their markers based off the list container's directionality instead.
14351434

14361435
<table class=propdef>
14371436
<tbody>
14381437
<tr>
14391438
<th>Property:
14401439

1441-
<td><dfn id=marker-attachment0>marker-attachment</dfn>
1440+
<td><dfn id=marker-side0>marker-side</dfn>
14421441

14431442
<tr>
14441443
<th>Value:
@@ -1453,7 +1452,7 @@ <h3 id=marker-attachment><span class=secno>7.2. </span> The ‘<a
14531452
<tr>
14541453
<th>Applies to:
14551454

1456-
<td><a href="#list-item"><i title="list item">list items</i></a>
1455+
<td><a href="#list-item"><i>list items</i></a>
14571456

14581457
<tr>
14591458
<th>Inherited:
@@ -1476,34 +1475,38 @@ <h3 id=marker-attachment><span class=secno>7.2. </span> The ‘<a
14761475
<td>specified value
14771476
</table>
14781477

1479-
<p>When a list item has ‘<code
1480-
class=css>marker-attachment:list-item</code>’, any <a
1478+
<p> When a list item has ‘<code
1479+
class=css>marker-side:list-item</code>’, any <a
14811480
href="#markers-associated-with-that-list-item"><i
14821481
title=associated-marker>markers associated with the list item</i></a> base
14831482
their positioning off of the directionality of the list item. When a list
1484-
item has ‘<code class=css>marker-attachment:list-container</code>’,
1485-
the <a href="#markers-associated-with-that-list-item"><i
1483+
item has ‘<code class=css>marker-side:list-container</code>’, the <a
1484+
href="#markers-associated-with-that-list-item"><i
14861485
title=associated-marker>associated markers</i></a> instead base their
14871486
positioning off of the directionality of the list item's parent element.
14881487
The normative meaning of this is specified in the section defining <a
14891488
href="#position-marker">position:marker</a>.
14901489

14911490
<div class=example>
1492-
<p>Here is a visual rendering of the effect that ‘<a
1493-
href="#marker-attachment0"><code
1494-
class=property>marker-attachment</code></a>’ can have on a list. Both
1495-
of the following renderings are generated from the following HTML, with
1496-
the only difference being the value of ‘<a
1497-
href="#marker-attachment0"><code
1498-
class=property>marker-attachment</code></a>’ on the list:
1491+
<p> Here is a visual rendering of the effect that ‘<a
1492+
href="#marker-side0"><code class=property>marker-side</code></a>’ can
1493+
have on a list. Both of the following renderings are generated from the
1494+
following HTML, with the only difference being the value of ‘<a
1495+
href="#marker-side0"><code class=property>marker-side</code></a>’ on
1496+
the list:
14991497

1500-
<pre>
1501-
&lt;ul>
1502-
&lt;li>english one
1503-
&lt;li dir=rtl>OWT WERBEH
1504-
&lt;li>english three
1505-
&lt;li dir=rtl>RUOF WERBEH
1506-
&lt;/ul></pre>
1498+
<pre><!--
1499+
-->&lt;ul>
1500+
<!--
1501+
--> &lt;li>english one
1502+
<!--
1503+
--> &lt;li dir=rtl>OWT WERBEH
1504+
<!--
1505+
--> &lt;li>english three
1506+
<!--
1507+
--> &lt;li dir=rtl>RUOF WERBEH
1508+
<!--
1509+
-->&lt;/ul></pre>
15071510

15081511
<table class=data style="width: 35em;">
15091512
<thead>
@@ -3304,7 +3307,7 @@ <h2 id=ua-stylesheet><span class=secno>14. </span> Sample style sheet for
33043307
display: block;
33053308
margin: 1em 0;
33063309
padding-left: 40px;
3307-
marker-attachment: list-container;
3310+
marker-side: list-container;
33083311
}
33093312

33103313
ol ol, ol ul, ul ul, ul ol {
@@ -3766,16 +3769,16 @@ <h2 class=no-num id=index>Index</h2>
37663769
<li>lower-roman, <a href="#lower-roman"
37673770
title=lower-roman><strong>12.</strong></a>
37683771

3769-
<li>marker-attachment, <a href="#marker-attachment0"
3770-
title=marker-attachment><strong>7.2.</strong></a>
3771-
37723772
<li>marker positioning edge, <a href="#marker-positioning-edge"
37733773
title="marker positioning edge"><strong>7.1.</strong></a>
37743774

37753775
<li>marker positioning reference element, <a
37763776
href="#marker-positioning-reference-element"
37773777
title="marker positioning reference element"><strong>7.1.</strong></a>
37783778

3779+
<li>marker-side, <a href="#marker-side0"
3780+
title=marker-side><strong>7.2.</strong></a>
3781+
37793782
<li>negative, <a href="#descdef-negative"
37803783
title=negative><strong>10.2.</strong></a>
37813784

‎css3-lists/Overview.src.html‎

Lines changed: 35 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -778,11 +778,11 @@ <h3 id='position-marker'>
778778
<dt><dfn>marker positioning reference element</dfn>
779779
<dd>
780780
<p>
781-
If the <i>ancestor list item</i> has ''marker-attachment:list-item'',
781+
If the <i>ancestor list item</i> has ''marker-side:list-item'',
782782
the <i>marker positioning reference element</i> is the <i>ancestor list item</i>.
783783

784784
<p>
785-
Otherwise, if the <i>ancestor list item</i> has ''marker-attachment:list-container'' and has a parent element,
785+
Otherwise, if the <i>ancestor list item</i> has ''marker-side:list-container'' and has a parent element,
786786
the <i>marker positioning reference element</i> is the <i>ancestor list item's</i> parent.
787787

788788
<p>
@@ -811,7 +811,7 @@ <h3 id='position-marker'>
811811

812812
<p class='note'>
813813
Note: The purpose of this somewhat convoluted definition is to position the marker flush against its list item,
814-
and then when "marker-attachment:list-container",
814+
and then when "marker-side:list-container",
815815
keep all the markers for a given list on the same side of their list items even in mixed-direction text,
816816
so that authors can specify padding on only one side of the list container and still ensure their markers are visible.
817817
And on top of all that,
@@ -873,15 +873,24 @@ <h3 id='position-marker'>
873873
and be confident that the reference will always be resolvable.
874874
</div>
875875

876-
<h3 id='marker-attachment'>
877-
The 'marker-attachment' property</h3>
876+
<h3 id='marker-side'>
877+
The 'marker-side' property</h3>
878878

879-
<p>By default, elements or ''::marker'' pseudo-elements with ''position:marker'' position themselves according to their list item's directionality. However, if the list item is grouped with several other list items which may have different directionality (for example, multiple &lt;li>s with different "dir" attributes in an &lt;ol> in HTML), it is sometimes more useful to have all the markers line up on one side, so the author can specify a single "gutter" on that side and be assured that all the markers will lie in that gutter and be visible. The 'marker-attachment' property defined in this section allows an author to control this, switching list items to positioning their markers based off the list container's directionality instead.
879+
<p>
880+
By default, elements or ''::marker'' pseudo-elements with ''position:marker''
881+
position themselves according to their list item's directionality.
882+
However, if the list item is grouped with several other list items which may have different directionality
883+
(for example, multiple &lt;li>s with different "dir" attributes in an &lt;ol> in HTML),
884+
it is sometimes more useful to have all the markers line up on one side,
885+
so the author can specify a single "gutter" on that side
886+
and be assured that all the markers will lie in that gutter and be visible.
887+
The 'marker-side' property defined in this section allows an author to control this,
888+
switching list items to positioning their markers based off the list container's directionality instead.
880889

881890
<table class="propdef">
882891
<tr>
883892
<th>Property:
884-
<td><dfn>marker-attachment</dfn>
893+
<td><dfn>marker-side</dfn>
885894
<tr>
886895
<th>Value:
887896
<td>list-item | list-container
@@ -890,7 +899,7 @@ <h3 id='marker-attachment'>
890899
<td>list-item
891900
<tr>
892901
<th>Applies to:
893-
<td><i title="list item">list items</i>
902+
<td><i>list items</i>
894903
<tr>
895904
<th>Inherited:
896905
<td>yes
@@ -905,18 +914,26 @@ <h3 id='marker-attachment'>
905914
<td>specified value
906915
</table>
907916

908-
<p>When a list item has ''marker-attachment:list-item'', any <i title='associated-marker'>markers associated with the list item</i> base their positioning off of the directionality of the list item. When a list item has ''marker-attachment:list-container'', the <i title='associated-marker'>associated markers</i> instead base their positioning off of the directionality of the list item's parent element. The normative meaning of this is specified in the section defining <a href="#position-marker">position:marker</a>.
917+
<p>
918+
When a list item has ''marker-side:list-item'',
919+
any <i title='associated-marker'>markers associated with the list item</i> base their positioning off of the directionality of the list item.
920+
When a list item has ''marker-side:list-container'',
921+
the <i title='associated-marker'>associated markers</i> instead base their positioning off of the directionality of the list item's parent element.
922+
The normative meaning of this is specified in the section defining <a href="#position-marker">position:marker</a>.
909923

910924
<div class='example'>
911-
<p>Here is a visual rendering of the effect that 'marker-attachment' can have on a list. Both of the following renderings are generated from the following HTML, with the only difference being the value of 'marker-attachment' on the list:
925+
<p>
926+
Here is a visual rendering of the effect that 'marker-side' can have on a list.
927+
Both of the following renderings are generated from the following HTML,
928+
with the only difference being the value of 'marker-side' on the list:
912929

913-
<pre>
914-
&lt;ul>
915-
&lt;li>english one
916-
&lt;li dir=rtl>OWT WERBEH
917-
&lt;li>english three
918-
&lt;li dir=rtl>RUOF WERBEH
919-
&lt;/ul></pre>
930+
<pre><!--
931+
-->&lt;ul>&#xa;<!--
932+
--> &lt;li>english one&#xa;<!--
933+
--> &lt;li dir=rtl>OWT WERBEH&#xa;<!--
934+
--> &lt;li>english three&#xa;<!--
935+
--> &lt;li dir=rtl>RUOF WERBEH&#xa;<!--
936+
-->&lt;/ul></pre>
920937

921938
<table class=data style="width: 35em;">
922939
<thead>
@@ -2234,7 +2251,7 @@ <h2 id='ua-stylesheet'>
22342251
display: block;
22352252
margin: 1em 0;
22362253
padding-left: 40px;
2237-
marker-attachment: list-container;
2254+
marker-side: list-container;
22382255
}
22392256

22402257
ol ol, ol ul, ul ul, ul ol {

0 commit comments

Comments
 (0)