Skip to content

Commit fc557ad

Browse files
authored
[css-regions-1] Tidy up values & fix build errors. (#12445)
* remove close slashes on img tags * tidy up references to CSS21 alias * use <custom-ident> not <ident> * use <dfn> for defining none keyword behaviour
1 parent f13f164 commit fc557ad

File tree

1 file changed

+35
-42
lines changed

1 file changed

+35
-42
lines changed

css-regions-1/Overview.bs

Lines changed: 35 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -112,15 +112,15 @@ Introduction</h2>
112112

113113
<figure style="float:left; margin:1em;">
114114
<img alt="Article and aside rendering without CSS Regions"
115-
src="images/linked-boxes-before.png"/>
115+
src="images/linked-boxes-before.png">
116116
<figcaption>
117117
Rendering without CSS Regions
118118
</figcaption>
119119
</figure>
120120

121121
<figure style="float:left; margin:1em;">
122122
<img alt="Article and aside rendering with CSS Regions"
123-
src="images/linked-boxes-after.png"/>
123+
src="images/linked-boxes-after.png">
124124
<figcaption>
125125
Rendering with CSS Regions
126126
</figcaption>
@@ -164,15 +164,15 @@ Introduction</h2>
164164

165165
<figure>
166166
<img alt="Wide nav bar showing all of the links"
167-
src="images/menu-wide.png"/>
167+
src="images/menu-wide.png">
168168
<figcaption>
169169
Wide rendering with menu shown
170170
</figcaption>
171171
</figure>
172172

173173
<figure>
174174
<img alt="Narrow nav bar with some of the links in the menu"
175-
src="images/menu-narrow.png"/>
175+
src="images/menu-narrow.png">
176176
<figcaption>
177177
Narrow rendering with menu shown
178178
</figcaption>
@@ -381,32 +381,32 @@ The 'flow-into' property</h3>
381381

382382
<pre class='propdef'>
383383
Name: flow-into
384-
Value: none | <<ident>> [element | content]?
384+
Value: none | <<custom-ident>> [element | content]?
385385
Initial: none
386386
Applies To: All elements, but not <a href="https://www.w3.org/TR/selectors/#pseudo-elements">pseudo-elements</a> such as <code>::first-line</code>, <code>::first-letter</code>, <code>::before</code> or <code>::after</code>.
387387
Inherited: no
388388
Computed Value: as specified
389389
Animation type: not animatable
390390
</pre>
391391

392-
<dl>
393-
<dt>none</dt>
392+
<dl dfn-type=value dfn-for=flow-into>
393+
<dt><dfn>none</dfn></dt>
394394

395395
<dd>
396396
The element is not moved
397397
to a <a>named flow</a>
398398
and normal CSS processing takes place.
399399
</dd>
400400

401-
<dt><a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a></dt>
401+
<dt><code><<custom-ident>> [ element | content ]?</code></dt>
402402

403403
<dd>
404404
If the keyword <dfn>element</dfn> is present
405405
or neither keyword is present,
406406
then the element is taken out
407407
of its parent's flow
408408
and placed into the flow
409-
with the name '<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>'.
409+
with the name '<<custom-ident>>'.
410410
If the keyword <dfn>content</dfn> is present,
411411
then only the element's contents
412412
are placed into the named flow.
@@ -468,7 +468,7 @@ The 'flow-into' property</h3>
468468

469469
Each <a>CSS Region</a> in a <a>region chain</a>
470470
establishes a containing block for absolutely positioned
471-
elements in the <a>named flow</a> (see [[!CSS21]]).
471+
elements in the <a>named flow</a> (see [[!CSS2]]).
472472
That first <a>CSS Region</a> in a <a>region chain</a>
473473
establishes the initial containing block for such absolutely
474474
positioned elements.
@@ -569,38 +569,37 @@ The 'flow-from' property</h3>
569569

570570
<pre class='propdef'>
571571
Name: flow-from
572-
Value: <<ident>> | none
572+
Value: <<custom-ident>> | none
573573
Initial: none
574574
Applies To: Non-replaced <a href="https://www.w3.org/TR/CSS21/visuren.html#block-boxes">block containers</a>. <br/> This might be expanded in future versions of the specification to allow other types of containers to receive flow content.
575575
Inherited: no
576576
Computed Value: as specified
577577
Animation type: not animatable
578578
</pre>
579579

580-
<dl>
581-
<dt><strong>none</strong></dt>
580+
<dl dfn-type=value dfn-for=flow-from>
581+
<dt><dfn>none</dfn></dt>
582582

583583
<dd>
584584
The block container is not a <a>CSS Region</a>.
585585
</dd>
586586

587-
<dt><strong><a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a></strong></dt>
587+
<dt><<custom-ident>></dt>
588588

589589
<dd>
590590
The block container becomes a <a>CSS Region</a>
591591
(except as detailed in the text below),
592592
and is ordered in a <a>region chain</a>
593593
according to its document order.
594-
The content from the flow
595-
with the <a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
594+
The content from the flow with the
595+
<<custom-ident>>
596596
name will be <a href="#region-flow-break">broken
597597
into fragments</a> and visually formatted in the
598598
<a href="https://www.w3.org/TR/CSS21/visuren.html#principal-box">principal boxes</a>
599599
of the <span>regions</span>
600600
in the <a>region chain</a>.
601-
<br/>
602-
If there is no flow with name
603-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>,
601+
602+
If there is no flow with name <<custom-ident>>,
604603
then the block container does not
605604
format any content visually.
606605
</dd>
@@ -626,11 +625,11 @@ The 'flow-from' property</h3>
626625

627626
Block container pseudo-elements where
628627
the value of 'flow-from' computes to an
629-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
628+
<<custom-ident>>
630629
and the value of 'content' computes to ''content/none''
631630
are generated as <a>CSS Regions</a>,
632631
which is an update to the behavior
633-
described in [[!CSS21]].
632+
described in [[!CSS2]].
634633

635634
If an element has <a>style containment</a> (See [[!CSS-CONTAIN-1]]),
636635
then the 'flow-from' property must be <a for=property>scoped</a> to that element.
@@ -639,7 +638,7 @@ The 'flow-from' property</h3>
639638

640639
A block container becomes a <a>CSS Region</a>
641640
when its 'flow-from' property is set
642-
to a valid <a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a> value,
641+
to a valid <<custom-ident>> value,
643642
even if there is no content contributing
644643
to the referenced flow.
645644
For example:
@@ -739,8 +738,7 @@ The 'flow-from' property</h3>
739738
Cycle Detection</h4>
740739

741740
<a>named flows</a> containing elements
742-
where the value of 'flow-from' computes to an
743-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
741+
where the value of 'flow-from' computes to a <<custom-ident>>
744742
can produce nonsensical circular relationships,
745743
such as a <a>named flow</a>
746744
containing <a>CSS Regions</a>
@@ -755,25 +753,20 @@ Cycle Detection</h4>
755753
<ul>
756754
<li>
757755
Every <a>named flow</a> depends on its elements
758-
where the value of 'flow-from' computes to an
759-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>.
756+
where the value of 'flow-from' computes to a <<custom-ident>>.
760757
</li>
761758
<li>
762759
Every element in a <a>named flow</a>
763-
where the value of 'flow-from' computes to an
764-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
760+
where the value of 'flow-from' computes to a <<custom-ident>>
765761
depends on the <a>named flow</a> with the
766-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
767-
name.
762+
<<custom-ident>> name.
768763
</li>
769764
</ul>
770765

771766
If the graph contains a cycle,
772767
any elements where the value of 'flow-from'
773-
computes to an
774-
<a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/syndata.html#value-def-identifier">&lt;ident&gt;</a>
775-
participating in the cycle
776-
do not become <a>CSS Regions</a>.
768+
computes to a <<custom-ident>> participating
769+
in the cycle do not become <a>CSS Regions</a>.
777770

778771
<div class="note"><span class="note-prefix">Note </span>
779772

@@ -979,7 +972,7 @@ The region-fragment property</h3>
979972
on the last line,
980973
the 'overflow' property controls
981974
the visibility of the overflowing content.
982-
See the 'overflow' property definition ([[CSS21]]).
975+
See the 'overflow' property definition ([[CSS2]]).
983976
</div>
984977

985978
<h2 id="cssom_view_and_css_regions">
@@ -1610,7 +1603,7 @@ The Region Flow Content Box (RFCB)</h3>
16101603
</ul>
16111604

16121605
<figure>
1613-
<img src="images/RFCB.svg" width=600 alt="The ::before, RFCB and ::after boxes contained in the Region Box"/>
1606+
<img src="images/RFCB.svg" width=600 alt="The ::before, RFCB and ::after boxes contained in the Region Box">
16141607
<figcaption>
16151608
The Region Flow Content Box (RFCB)
16161609
</figcaption>
@@ -1631,7 +1624,7 @@ RFCB 'width' resolution</h4>
16311624
At various points in the visual formatting of documents containing regions,
16321625
the used 'width' of RFCBs and regions need to be resolved.
16331626
In all cases, the resolution is done following the rules for
1634-
<a href="https://www.w3.org/TR/CSS2/visudet.html#Computing_widths_and_margins">calculating widths and margins</a> (see [[!CSS21]]).
1627+
<a href="https://www.w3.org/TR/CSS2/visudet.html#Computing_widths_and_margins">calculating widths and margins</a> (see [[!CSS2]]).
16351628
Sometimes, resolving the used 'width' value requires
16361629
measuring the content's <code>min-content</code>
16371630
and <code>max-content</code> values
@@ -1674,7 +1667,7 @@ Regions visual formatting steps</h3>
16741667
</ul>
16751668

16761669
<figure>
1677-
<img src="images/regions-layout-three-steps.svg" width=600 alt="visual representation of the three-step process"/>
1670+
<img src="images/regions-layout-three-steps.svg" width=600 alt="visual representation of the three-step process">
16781671
<figcaption>
16791672
Regions visual formatting steps
16801673
</figcaption>
@@ -1904,7 +1897,7 @@ Step 1 - Phase 1: Laying out RFCBs with used height of zero</h4>
19041897
Conceptually, this produces the layout illustrated below.
19051898

19061899
<figure>
1907-
<img src="images/flow-fragment-height-phase-1.png" width=500 alt="Step 1 - Phase 1: Layout RFCBs with used heights of 0"/>
1900+
<img src="images/flow-fragment-height-phase-1.png" width=500 alt="Step 1 - Phase 1: Layout RFCBs with used heights of 0">
19081901
<figcaption>
19091902
Step 1 - Phase 1: Layout RFCBs with used heights of 0
19101903
</figcaption>
@@ -1941,7 +1934,7 @@ Step 1 - Phase 2: Layout flow to compute the RFCBs' flow fragments heights</h4>
19411934
This results in a resolved flow fragment height: FH-C.
19421935

19431936
<figure>
1944-
<img src="images/flow-fragment-height-phase-2.png" width=370 alt="Step 1 - Phase 2: Measure flow fragments heights"/>
1937+
<img src="images/flow-fragment-height-phase-2.png" width=370 alt="Step 1 - Phase 2: Measure flow fragments heights">
19451938
<figcaption>
19461939
Step 1 - Phase 2: Measure flow fragments heights
19471940
</figcaption>
@@ -1973,7 +1966,7 @@ Step 2: Layout document and regions without named flows</h4>
19731966
FH-C becomes rC's used 'height'.
19741967

19751968
<figure>
1976-
<img src="images/regions-visual-formatting-step-2.png" width=370 alt="Step 2: Layout document and regions without named flows"/>
1969+
<img src="images/regions-visual-formatting-step-2.png" width=370 alt="Step 2: Layout document and regions without named flows">
19771970
<figcaption>
19781971
Step 2: Layout document and regions without <a>named flows</a>
19791972
</figcaption>
@@ -2004,7 +1997,7 @@ Step 3: named flows layout</h4>
20041997
computed in Step 1 Phase 2.
20051998

20061999
<figure>
2007-
<img src="images/regions-visual-formatting-step-3.png" width=370 alt="Step 3: Final result after laying out named flows in regions"/>
2000+
<img src="images/regions-visual-formatting-step-3.png" width=370 alt="Step 3: Final result after laying out named flows in regions">
20082001
<figcaption>
20092002
Step 3: Final result after laying out <a>named flows</a> in regions
20102003
</figcaption>

0 commit comments

Comments
 (0)