Skip to content

Commit cda3220

Browse files
committed
[css-scroll-snap] Wording tweaks. Make it clear that automatic block/inline is chosen wrt the element's scroll container, not itself (that would be silly).
1 parent d82634f commit cda3220

1 file changed

Lines changed: 14 additions & 13 deletions

File tree

css-scroll-snap/Overview.bs

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -489,27 +489,28 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
489489
<dl>
490490
<dt id=scroll-snap-align-none>none
491491
<dd>
492-
The element does not specify any <a>snap positions</a> at all,
492+
Specifies that the box contributes no <a>snap positions</a> at all,
493493
i.e. both axes compute to ''scroll-snap-align/none''.
494494

495495
<dt id=scroll-snap-align-single>[ block | inline ]? [ edges | <<snap-alignment>> ]
496496
<dd>
497-
The element declares a single <a>1D snap position</a>,
498-
in either the <a>block</a> or <a>inline</a> axis,
499-
as specified,
500-
and the other axis computes to ''scroll-snap-align/none''.
497+
Specifies a <a>1D snap position</a>
498+
in either the <a>block</a> or <a>inline</a> axis.
501499

502-
If neither <css>block</css> nor <css>inline</css> is specified,
503-
the axis is automatically chosen:
500+
If a <dfn for=scroll-snap-align type=value>block</dfn> or <dfn for=scroll-snap-align type=value>inline</dfn> keyword is specified,
501+
the specified alignment is for that axis,
502+
and the other axis computes to ''scroll-snap-align/none''.
503+
Otherwise,
504+
the used axis is automatically chosen:
504505

505-
* If the element is only scrollable in one axis
506+
* If the box’s nearest <a>scroll container</a> is only scrollable in one axis
506507
(only one axis has its 'overflow' set to ''overflow/auto'' or ''overflow/scroll'')
507508
the scrollable axis is chosen.
508-
* Otherwise, the <a>block</a> axis is chosen.
509+
* Otherwise, the nearest <a>scroll container</a>’s <a>block axis</a> is chosen.
509510

510511
<dt id=scroll-snap-align-double>[ none | edges | <<snap-alignment>> ]{2}
511512
<dd>
512-
The element declares two <a>1D snap positions</a>,
513+
Specifies two <a>1D snap positions</a>,
513514
one in each axis.
514515
The first value is in the <a>inline</a> axis,
515516
and the second is in the <a>block</a> axis.
@@ -519,10 +520,10 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
519520
The element declares a <a>2D snap position</a>.
520521

521522
If both alignments are given,
522-
the first refers to the <a>inline</a> axis
523-
and the second refers to the <a>block</a> axis.
523+
the first applies to the <a>inline</a> axis
524+
and the second applies to the <a>block</a> axis.
524525
If only one is given,
525-
the position refers to both axises.
526+
the position applies to both axises.
526527
</dl>
527528

528529
For all of these values,

0 commit comments

Comments
 (0)