- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 22 Jul 2011 20:23:15 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-lists
In directory hutz:/tmp/cvs-serv29484
Modified Files:
Overview.html Overview.src.html
Log Message:
Fixed definition of position:marker to handle the list item not having a parent element.
Reworded position:marker to be clearer.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.html,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- Overview.html 20 Jul 2011 01:59:01 -0000 1.70
+++ Overview.html 22 Jul 2011 20:23:13 -0000 1.71
@@ -26,12 +26,12 @@
<h1>CSS Lists and Counters Module Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 July 2011</h2>
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 22 July 2011</h2>
<dl>
<dt>This version:
- <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-lists-20110720">http://www.w3.org/TR/2011/WD-css3-lists-20110720</a></dd>-->
+ <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-lists-20110722">http://www.w3.org/TR/2011/WD-css3-lists-20110722</a></dd>-->
<a
href="http://dev.w3.org/csswg/css3-lists/">http://dev.w3.org/csswg/css3-lists/</a>
@@ -1183,20 +1183,44 @@
flow</a>. <span class=note>In the Positioned Layout Module this will be
defined more precisely in terms of placeholders.</span>
- <p>To calculate the element's horizontal position, first define the
- element's nearest list item ancestor element as the <dfn
- id=ancestor-list-item>ancestor list item</dfn>. If the <a
- href="#ancestor-list-item"><i>ancestor list item</i></a>‘<code
- class=css>s </code>’marker-attachment' property has the value
- ‘<code class=css>list-item</code>’, set the <dfn
- id=marker-positioning-reference-element>marker positioning reference
- element</dfn> to the <a href="#ancestor-list-item"><i>ancestor list
- item</i></a>; if the property has the value ‘<code
- class=css>list-container</code>’, set the <a
- href="#marker-positioning-reference-element"><i>marker positioning
- reference element</i></a> to the <a href="#ancestor-list-item"><i>ancestor
- list item</i></a>‘<code class=css>s parent element. The
- element</code>’s horizontal position must then be set such that the
+ <p>To calculate the element's horizontal position, we must first define a
+ few terms:
+
+ <dl>
+ <dt><dfn id=ancestor-list-item>ancestor list item</dfn>
+
+ <dd>The <a href="#ancestor-list-item"><i>ancestor list item</i></a> is the
+ marker's nearest list item ancestor. <span class=note>The marker is
+ guaranteed to have a list item ancestor, or else its ‘<code
+ class=property>position</code>’ property would have computed to
+ ‘<code class=css>relative</code>’ instead.</span>
+
+ <dt><dfn id=marker-positioning-reference-element>marker positioning
+ reference element</dfn>
+
+ <dd>
+ <p>If the <a href="#ancestor-list-item"><i>ancestor list item</i></a> has
+ ‘<code class=css>marker-attachment:list-item</code>’, the <a
+ href="#marker-positioning-reference-element"><i>marker positioning
+ reference element</i></a> is the <a
+ href="#ancestor-list-item"><i>ancestor list item</i></a>.</p>
+
+ <p>Otherwise, if the <a href="#ancestor-list-item"><i>ancestor list
+ item</i></a> has ‘<code
+ class=css>marker-attachment:list-container</code>’ and has a
+ parent element, the <a
+ href="#marker-positioning-reference-element"><i>marker positioning
+ reference element</i></a> is the <a
+ href="#ancestor-list-item"><i>ancestor list item</i></a>‘<code
+ class=css>s parent.</code></p>
+
+ <p>Otherwise, the <a
+ href="#marker-positioning-reference-element"><i>marker positioning
+ reference element</i></a> is the <a
+ href="#ancestor-list-item"><i>ancestor list item</i></a>.</p>
+ </dl>
+
+ <p>The element’s horizontal position must then be set such that the
margin edge of the element corresponding to the "end" edge of the <a
href="#marker-positioning-reference-element"><i>marker positioning
reference element</i></a> is flush with the border edge of the <a
@@ -1249,8 +1273,8 @@
assured that all the markers will lie in that gutter and be visible. The
‘<a href="#marker-attachment0"><code
class=property>marker-attachment</code></a>’ property defined in
- this section allows an author to control this, switching markers to
- positioning themselves based off the list container's directionality
+ this section allows an author to control this, switching list items to
+ positioning their markers based off the list container's directionality
instead.
<table class=propdef>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v
retrieving revision 1.119
retrieving revision 1.120
diff -u -d -r1.119 -r1.120
--- Overview.src.html 20 Jul 2011 01:59:01 -0000 1.119
+++ Overview.src.html 22 Jul 2011 20:23:13 -0000 1.120
@@ -729,7 +729,23 @@
<p>The element's vertical position is calculated according to the <a href="http://www.w3.org/TR/CSS21/visuren.html#normal-flow">normal flow</a>. <span class='note'>In the Positioned Layout Module this will be defined more precisely in terms of placeholders.</span></p>
- <p>To calculate the element's horizontal position, first define the element's nearest list item ancestor element as the <dfn>ancestor list item</dfn>. If the <i>ancestor list item</i>'s 'marker-attachment' property has the value ''list-item'', set the <dfn>marker positioning reference element</dfn> to the <i>ancestor list item</i>; if the property has the value ''list-container'', set the <i>marker positioning reference element</i> to the <i>ancestor list item</i>'s parent element. The element's horizontal position must then be set such that the margin edge of the element corresponding to the "end" edge of the <i>marker positioning reference element</i> is flush with the border edge of the <i>ancestor list item</i> corresponding to the "start" edge of the <i>marker positioning reference element</i>.</p>
+ <p>To calculate the element's horizontal position, we must first define a few terms:</p>
+
+ <dl>
+ <dt><dfn>ancestor list item</dfn></dt>
+ <dd>The <i>ancestor list item</i> is the marker's nearest list item ancestor. <span class=note>The marker is guaranteed to have a list item ancestor, or else its 'position' property would have computed to ''relative'' instead.</span></dd>
+
+ <dt><dfn>marker positioning reference element</dfn></dt>
+ <dd>
+ <p>If the <i>ancestor list item</i> has ''marker-attachment:list-item'', the <i>marker positioning reference element</i> is the <i>ancestor list item</i>.</p>
+
+ <p>Otherwise, if the <i>ancestor list item</i> has ''marker-attachment:list-container'' and has a parent element, the <i>marker positioning reference element</i> is the <i>ancestor list item</i>'s parent.</p>
+
+ <p>Otherwise, the <i>marker positioning reference element</i> is the <i>ancestor list item</i>.</p>
+ </dd>
+ </dl>
+
+ <p>The element's horizontal position must then be set such that the margin edge of the element corresponding to the "end" edge of the <i>marker positioning reference element</i> is flush with the border edge of the <i>ancestor list item</i> corresponding to the "start" edge of the <i>marker positioning reference element</i>.</p>
<p class='note'>The purpose of this somewhat convoluted definition is to position the marker flush against its list item, and then when "marker-attachment:list-container", keep all the markers for a given list on the same side of their list items even in mixed-direction text, so that authors can specify padding on only one side and still ensure their markers are visible.</p>
@@ -748,7 +764,7 @@
<h3 id='marker-attachment'>
The 'marker-attachment' property</h3>
- <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 <li>s with different "dir" attributes in an <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 markers to positioning themselves based off the list container's directionality instead.</p>
+ <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 <li>s with different "dir" attributes in an <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.</p>
<table class="propdef">
<tr>
Received on Friday, 22 July 2011 20:23:17 UTC