Skip to content

Commit f798fa3

Browse files
jav099Javier Contreras
andauthored
[css-gaps-1] Change rule-break: spanning-item to rule-break: normal w3c#13127 (w3c#13475)
Co-authored-by: Javier Contreras <javiercon@microsoft.com>
1 parent ef19863 commit f798fa3

3 files changed

Lines changed: 50 additions & 13 deletions

File tree

css-gaps-1/Overview.bs

Lines changed: 50 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -351,8 +351,8 @@ Breaking gap decorations into segments: The 'column-rule-break', 'row-rule-break
351351

352352
<pre class='propdef'>
353353
Name: column-rule-break, row-rule-break
354-
Value: ''none'' | ''spanning-item'' | ''intersection''
355-
Initial: ''spanning-item''
354+
Value: ''none'' | ''normal'' | ''intersection''
355+
Initial: ''normal''
356356
Applies to: <a>grid containers</a>, <a>flex containers</a>, <a>multicol containers</a>, and <a>grid lanes containers</a>
357357
Inherited: no
358358
Animation type: discrete
@@ -368,18 +368,36 @@ Breaking gap decorations into segments: The 'column-rule-break', 'row-rule-break
368368
Gap decorations do not start or end at visible "T" or "cross" intersections.
369369
Instead, a single continuous decoration is painted from one end of the gap to the other.
370370
</dd>
371-
<dt><dfn>spanning-item</dfn>
371+
<dt><dfn>normal</dfn>
372372
<dd>
373-
Gap decorations start and end at visible "T" intersections but continue through visible "cross" intersections.
373+
Behavior depends on the type of container.
374+
375+
<dl>
376+
<dt><a>Grid containers</a>
377+
<dd>
378+
Gap decorations start and end at visible "T" intersections
379+
but continue through visible "cross" intersections.
380+
</dd>
381+
<dt><a>Flex containers</a>
382+
<dd>
383+
Because flex items do not span across flex lines,
384+
there are no visible "T" intersections caused by spanning items,
385+
so in practice this is identical to ''column-rule-break/none''.
386+
</dd>
387+
<dt><a>Multicol containers</a>
388+
<dd>
389+
In order to preserve the traditional readability of text in columns,
390+
'column-rule-break' behaves as ''column-rule-break/intersection'', and
391+
'row-rule-break' behaves as ''row-rule-break/none''.
392+
</dd>
393+
</dl>
374394
</dd>
375395
<dt><dfn>intersection</dfn>
376396
<dd>
377397
Gap decorations start and end at visible "T" and "cross" intersections.
378398
</dd>
379399
</dl>
380400

381-
Issue: Bikeshed these values.
382-
383401
<pre class='propdef shorthand'>
384402
Name: rule-break
385403
Value: <<'column-rule-break'>>
@@ -489,7 +507,7 @@ Pairing gap intersection points into segments</h4>
489507
|break| is ''column-rule-break/none''.
490508
</li>
491509
<li>
492-
|break| is ''column-rule-break/spanning-item'',
510+
|break| is ''column-rule-break/normal'',
493511
and |start| is not <a>discontiguous</a> with the first item in |endpoints|.
494512
</li>
495513
<li>
@@ -549,17 +567,17 @@ Pairing gap intersection points into segments</h4>
549567

550568
<div class="example">
551569
<pre>
552-
.break-spanning-item-grid {
570+
.break-normal-grid {
553571
display: grid;
554572
grid-template: repeat(4, 100px) / repeat(4, 100px);
555573
gap: 20px;
556574
row-rule: 6px solid red;
557575
column-rule: 6px solid blue;
558-
rule-break: spanning-item;
576+
rule-break: normal;
559577
}
560578
</pre>
561579
<figure>
562-
<img alt="" src="images/example-break-spanning-item-grid.png">
580+
<img alt="" src="images/example-break-normal-grid.png">
563581
<figcaption>
564582
Grid <a>gap decorations</a> broken at <a>gap intersection points</a>
565583
that are not adjacent to spanning items.
@@ -587,6 +605,25 @@ Pairing gap intersection points into segments</h4>
587605
</figure>
588606
</div>
589607

608+
<div class="example">
609+
<pre>
610+
.break-normal-multicol {
611+
gap: 10px;
612+
row-rule: 4px solid red;
613+
column-rule: 4px solid blue;
614+
rule-break: normal;
615+
}
616+
</pre>
617+
<figure>
618+
<img alt="" src="images/example-break-normal-multicol.png">
619+
<figcaption>
620+
Multicol <a>gap decorations</a> with rule-break set to ''normal''.
621+
Note that in the column direction it behaves as if rule-break were set to ''intersection'',
622+
while in the row direction it behaves as if rule-break were set to ''none''.
623+
</figcaption>
624+
</figure>
625+
</div>
626+
590627
<div class="example">
591628
<pre>
592629
.break-none-flex {
@@ -610,7 +647,7 @@ Pairing gap intersection points into segments</h4>
610647
</div>
611648

612649
Note: Because flexbox has no concept of spanning items,
613-
''column-rule-break/spanning-item'' on a flexbox has the same effect as
650+
''column-rule-break/normal'' on a flexbox has the same effect as
614651
''column-rule-break/none''.
615652

616653
<div class="example">
@@ -1027,7 +1064,7 @@ Controlling Gap Decoration Visibility: The '*-rule-visibility-items' properties<
10271064

10281065
<div class="example">
10291066
<pre>
1030-
.break-spanning-item-with-around-grid {
1067+
.break-normal-with-around-grid {
10311068
display: grid;
10321069
grid-template: repeat(3, 100px) / repeat(3, 100px);
10331070
gap: 20px;
@@ -1039,7 +1076,7 @@ Controlling Gap Decoration Visibility: The '*-rule-visibility-items' properties<
10391076
<figure>
10401077
<img alt="" src="images/example-vis-rules-around-spn.png">
10411078
<figcaption>
1042-
Gap decorations with 'rule-break' ''column-rule-break/spanning-item'' and 'rule-visibility-items' ''column-rule-visibility-items/around''.
1079+
Gap decorations with 'rule-break' ''column-rule-break/normal'' and 'rule-visibility-items' ''column-rule-visibility-items/around''.
10431080
</figcaption>
10441081
</figure>
10451082
</div>
File renamed without changes.
143 KB
Loading

0 commit comments

Comments
 (0)