@@ -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- <style>
629- ol { list-style: none; }
630- .marker { position: marker; }
631- </style>
632- <ol>
633- <li>
634- <span class='marker' >(a)</span> Definitions.— For purposes of this section—
635- <ol>
636- <li><span class='marker' >(1)</span> the term “agency” means agency as...
637- <li><span class='marker' >(2)</span> the term “individual” means a citizen...
638- </ol>
639- <li>
640- <span class='marker' >(b)</span> Conditions of Disclosure.— No agency shall disclose...
641- <ol>
642- <li><span class='marker' >(1)</span> to those officers and employees of the agency...
643- <li><span class='marker' >(2)</span> required under section 552 of this title;
644- </ol>
645- </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