Skip to content

Commit a77d027

Browse files
committed
[css-lists] Remove the position:marker value. We might revisit it later.
1 parent f71545c commit a77d027

1 file changed

Lines changed: 0 additions & 121 deletions

File tree

css-lists-3/Overview.bs

Lines changed: 0 additions & 121 deletions
Original file line numberDiff line numberDiff line change
@@ -542,127 +542,6 @@ Marker Positioning</h2>
542542
It is an unreviewed rough draft that hasn't even been properly checked for Web-compatibility.
543543
Feel free to send feedback, but DON'T USE THIS PART OF THE SPEC.</strong>
544544

545-
<h3 id='position-marker'>
546-
The ''marker'' value for 'position'</h3>
547-
548-
This section introduces a new positioning scheme,
549-
designed to model the way in which ''list-style-position:outside'' list markers were traditionally positioned in CSS 2.1.
550-
Outside list markers now have their positioning defined in terms of this new value.
551-
552-
The new positioning scheme defined in this section can be used on all elements,
553-
not just ''::marker'' pseudo-elements.
554-
For example, this can be used to position explicit elements serving as markers in a legal document,
555-
so that the list item has a marker whose value is guaranteed to be correct regardless of whether the CSS is applied
556-
(often a requirement in legal documents),
557-
but which is positioned like a native CSS marker.
558-
559-
<pre class="propdef partial">
560-
Name: position
561-
New values: marker
562-
Computed value: see prose, otherwise same as normal
563-
</pre>
564-
565-
The <dfn value for=position>marker</dfn> value for 'position' depends on the element it is set on having a <a>list item</a> ancestor.
566-
If the specified value of 'position' is ''position/marker''
567-
and the element does not have a <a>list item</a> ancestor,
568-
'position' must compute to ''position/relative'' on the element.
569-
An element with ''position:marker'' counts as <a>absolutely positioned</a>.
570-
571-
To calculate the marker's position, we must first define a few terms:
572-
573-
<dl>
574-
<dt><dfn>ancestor list item</dfn>
575-
<dd>The <a>ancestor list item</a> is the marker's nearest list item ancestor element.
576-
577-
<dt><dfn>marker positioning reference element</dfn>
578-
<dd>
579-
If the <a>ancestor list item</a> has ''marker-side:list-item'',
580-
the <a>marker positioning reference element</a> is the <a>ancestor list item</a>.
581-
582-
Otherwise, if the <a>ancestor list item</a> has ''marker-side:list-container'' and has a parent element,
583-
the <a>marker positioning reference element</a> is that parent.
584-
585-
Otherwise, the <a>marker positioning reference element</a> is the <a>ancestor list item</a>.
586-
587-
588-
<dt><dfn>list item positioning edge</dfn>
589-
<dd>
590-
The border edge of the <a>ancestor list item</a> corresponding to the "inline-start" edge of the <a>marker positioning reference element</a>.
591-
592-
<dt><dfn>marker positioning edge</dfn>
593-
<dd>
594-
The outer edge of the marker that's on the opposite side from the <a>list item positioning edge</a>.
595-
For example, if the <a>list item positioning edge</a> ended up being the left border edge of the <a>ancestor list item</a>,
596-
the <a>marker positioning edge</a> would be the right margin edge of the marker.
597-
</dl>
598-
599-
The marker's position in the <a>ancestor list item</a>’s block axis
600-
is calculated according to the <a href="https://www.w3.org/TR/CSS21/visuren.html#normal-flow">normal flow</a>.
601-
602-
The marker's position in the <a>ancestor list item's</a> inline axis must be set such that
603-
the <a>marker positioning edge</a> is flush with the <a>list item positioning edge</a>.
604-
605-
Note: The purpose of this somewhat convoluted definition is to position the marker flush against its list item,
606-
and then when "marker-side:list-container",
607-
keep all the markers for a given list on the same side of their list items even in mixed-direction text,
608-
so that authors can specify padding on only one side of the list container and still ensure their markers are visible.
609-
And on top of all that,
610-
do something reasonable in the face of potentially differing writing-modes
611-
on the marker, list item, and container.
612-
613-
All elements or pseudo-elements with ''position:marker''
614-
that share a common <a>ancestor list item</a>
615-
are known as <dfn lt='associated marker'>markers associated with that list item</dfn>.
616-
617-
The 'top', 'right', 'bottom', and 'left' properties specify offsets
618-
relative to the top, right, bottom, and left edges (respectively) of the element itself,
619-
similar to how relative positioning works.
620-
621-
<div class='example'>
622-
''position:marker'' can be used when the precise list marker is important for the content,
623-
not a stylistic choice,
624-
but the normal <em>appearance</em> of lists is still desired.
625-
For example, this trimmed snippet of the US Code of Laws may be marked up as the following in HTML:
626-
627-
<pre highlight=html>
628-
&lt;style>
629-
ol { list-style: none; }
630-
.marker { position: marker; }
631-
&lt;/style>
632-
&lt;ol>
633-
&lt;li>
634-
&lt;span class='marker'>(a)&lt;/span> Definitions.— For purposes of this section—
635-
&lt;ol>
636-
&lt;li>&lt;span class='marker'>(1)&lt;/span> the term “agency” means agency as...
637-
&lt;li>&lt;span class='marker'>(2)&lt;/span> the term “individual” means a citizen...
638-
&lt;/ol>
639-
&lt;li>
640-
&lt;span class='marker'>(b)&lt;/span> Conditions of Disclosure.— No agency shall disclose...
641-
&lt;ol>
642-
&lt;li>&lt;span class='marker'>(1)&lt;/span> to those officers and employees of the agency...
643-
&lt;li>&lt;span class='marker'>(2)&lt;/span> required under section 552 of this title;
644-
&lt;/ol>
645-
&lt;/ol>
646-
</pre>
647-
648-
The preceding document should render something like this:
649-
650-
<pre>
651-
(a) Definitions.— For purposes of this section—
652-
(1) the term “agency” means agency as...
653-
(2) the term “individual” means a citizen...
654-
(b) Conditions of Disclosure.— No agency shall disclose...
655-
(1) to those officers and employees of the agency...
656-
(2) required under section 552 of this title;
657-
</pre>
658-
659-
Importantly, even if the stylesheet is unavailable,
660-
the list markers will appear the same
661-
(though they will be positioned slightly differently),
662-
so other documents can refer to those list markers
663-
and be confident that the reference will always be resolvable.
664-
</div>
665-
666545
<!--
667546
██ ██ ███ ████████ ██ ██ ████████ ████████ ██████ ████ ████████ ████████
668547
███ ███ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██

0 commit comments

Comments
 (0)