W3C home > Mailing lists > Public > public-css-commits@w3.org > July 2011

csswg/css3-lists Overview.html,1.70,1.71 Overview.src.html,1.119,1.120

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
Message-Id: <E1QkMFf-0007gq-F4@lionel-hutz.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>&lsquo;<code
-   class=css>s </code>&rsquo;marker-attachment' property has the value
-   &lsquo;<code class=css>list-item</code>&rsquo;, 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 &lsquo;<code
-   class=css>list-container</code>&rsquo;, 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>&lsquo;<code class=css>s parent element. The
-   element</code>&rsquo;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 &lsquo;<code
+    class=property>position</code>&rsquo; property would have computed to
+    &lsquo;<code class=css>relative</code>&rsquo; 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
+     &lsquo;<code class=css>marker-attachment:list-item</code>&rsquo;, 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 &lsquo;<code
+     class=css>marker-attachment:list-container</code>&rsquo; 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>&lsquo;<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&rsquo;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
    &lsquo;<a href="#marker-attachment0"><code
    class=property>marker-attachment</code></a>&rsquo; 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 &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 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 &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.</p>
 
 	<table class="propdef">
 		<tr>
Received on Friday, 22 July 2011 20:23:17 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 22 July 2011 20:23:18 GMT