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

csswg/css3-lists Overview.html,1.103,1.104 Overview.src.html,1.150,1.151

From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 18 Nov 2011 23:44:44 +0000
To: public-css-commits@w3.org
Message-Id: <E1RRY6u-0007f4-G4@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-lists
In directory hutz:/tmp/cvs-serv29436

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Added an example for position:marker.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.html,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -d -r1.103 -r1.104
--- Overview.html	18 Nov 2011 22:31:02 -0000	1.103
+++ Overview.html	18 Nov 2011 23:44:42 -0000	1.104
@@ -1237,6 +1237,51 @@
    the top, right, bottom, and left edges (respectively) of the element
    itself, similar to how relative positioning works.
 
+  <div class=example>
+   <p>&lsquo;<code class=css>position:marker</code>&rsquo; can be used when
+    the precise list marker is important for the content, not a stylistic
+    choice, but the normal <em>appearance</em> of lists is still desired. For
+    example, this trimmed snippet of the US Code of Laws may be marked up as
+    the following in HTML:</p>
+
+   <pre>
+&lt;style>
+ol { list-style: none; }
+.marker { position: marker; }
+&lt;/style>
+&lt;ol>
+   &lt;li>
+      &lt;span class='marker'>(a)&lt;/span> Definitions.— For purposes of this section—
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> the term “agency” means agency as...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> the term “individual” means a citizen...&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+   &lt;li>
+      &lt;span class='marker'>(b)&lt;/span> Conditions of Disclosure.— No agency shall disclose...
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> to those officers and employees of the agency which...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> required under section 552 of this title;&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+&lt;/ol></pre>
+
+   <p>The preceding document should render something like this:</p>
+
+   <pre>
+ (a) Definitions.— For purposes of this section—
+     (1) the term “agency” means agency as...
+     (2) the term “individual” means a citizen...
+ (b) Conditions of Disclosure.— No agency shall disclose...
+     (1) to those officers and employees of the agency which...
+     (2) required under section 552 of this title;</pre>
+
+   <p>Importantly, it will <strong>always</strong> be presented something
+    like that, with those exact list markers, even if the stylesheet is
+    unavailable, so other documents can refer to those list markers and be
+    confident that the reference will always be resolvable.</p>
+  </div>
+
   <h3 id=marker-attachment><span class=secno>7.2. </span> The &lsquo;<a
    href="#marker-attachment0"><code
    class=property>marker-attachment</code></a>&rsquo; property</h3>

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v
retrieving revision 1.150
retrieving revision 1.151
diff -u -d -r1.150 -r1.151
--- Overview.src.html	18 Nov 2011 22:31:02 -0000	1.150
+++ Overview.src.html	18 Nov 2011 23:44:42 -0000	1.151
@@ -703,6 +703,44 @@
 
 	<p>The 'top', 'right', 'bottom', and 'left' properties specify offsets relative to the top, right, bottom, and left edges (respectively) of the element itself, similar to how relative positioning works.</p>
 
+	<div class='example'>
+		<p>''position:marker'' can be used when the precise list marker is important for the content, not a stylistic choice, but the normal <em>appearance</em> of lists is still desired.  For example, this trimmed snippet of the US Code of Laws may be marked up as the following in HTML:</p>
+
+		<pre>
+&lt;style>
+ol { list-style: none; }
+.marker { position: marker; }
+&lt;/style>
+&lt;ol>
+   &lt;li>
+      &lt;span class='marker'>(a)&lt;/span> Definitions.— For purposes of this section—
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> the term “agency” means agency as...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> the term “individual” means a citizen...&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+   &lt;li>
+      &lt;span class='marker'>(b)&lt;/span> Conditions of Disclosure.— No agency shall disclose...
+      &lt;ol>
+         &lt;li>&lt;span class='marker'>(1)&lt;/span> to those officers and employees of the agency which...&lt;/li>
+         &lt;li>&lt;span class='marker'>(2)&lt;/span> required under section 552 of this title;&lt;/li>
+      &lt;/ol>
+   &lt;/li>
+&lt;/ol></pre>
+
+		<p>The preceding document should render something like this:</p>
+
+		<pre>
+ (a) Definitions.— For purposes of this section—
+     (1) the term “agency” means agency as...
+     (2) the term “individual” means a citizen...
+ (b) Conditions of Disclosure.— No agency shall disclose...
+     (1) to those officers and employees of the agency which...
+     (2) required under section 552 of this title;</pre>
+
+		<p>Importantly, it will <strong>always</strong> be presented something like that, with those exact list markers, even if the stylesheet is unavailable, so other documents can refer to those list markers and be confident that the reference will always be resolvable.</p>
+	</div>
+
 <h3 id='marker-attachment'>
 The 'marker-attachment' property</h3>
 
Received on Friday, 18 November 2011 23:44:49 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 18 November 2011 23:44:52 GMT