Skip to content

Commit 00816c6

Browse files
committed
[css-display-4] Adds source-order value for reading-flow
As per resolution in #11208 (comment)
1 parent 8498898 commit 00816c6

File tree

1 file changed

+37
-5
lines changed

1 file changed

+37
-5
lines changed

css-display-4/Overview.bs

Lines changed: 37 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1166,7 +1166,7 @@ Reordering and Accessibility</h3>
11661166
<h2 id='reading-flow'>
11671167
Reading Order: the 'reading-flow' property</h2>
11681168

1169-
A <dfn export>reading flow container</dfn> is a flex or grid container
1169+
A <dfn export>reading flow container</dfn> is a block, flex or grid container
11701170
with a valid 'reading-flow' value other than ''normal''.
11711171

11721172
The <dfn export>rendering-defined sibling reading flow</dfn> of a <a>reading flow container</a>
@@ -1179,16 +1179,16 @@ ISSUE(9922): Should this property also apply to tables?
11791179

11801180
<pre class='propdef'>
11811181
Name: reading-flow
1182-
Value: normal | flex-visual | flex-flow | grid-rows | grid-columns | grid-order
1182+
Value: normal | source-order | flex-visual | flex-flow | grid-rows | grid-columns | grid-order
11831183
Initial: normal
1184-
Applies to: flex and grid containers
1184+
Applies to: block, flex and grid containers
11851185
Inherited: no
11861186
Computed value: as specified
11871187
Animation type: not animatable
11881188
</pre>
11891189

11901190
The 'reading-flow' property controls the order in which
1191-
elements in a flex or grid layout are rendered to speech
1191+
elements are rendered to speech
11921192
or are navigated to when using (linear) sequential navigation methods.
11931193

11941194
It takes one keyword value. Values are defined as follows:
@@ -1197,6 +1197,13 @@ ISSUE(9922): Should this property also apply to tables?
11971197
<dt><dfn>normal</dfn>
11981198
<dd>
11991199
Follow the order of elements in the DOM.
1200+
<dt><dfn>source-order</dfn>
1201+
<dd>
1202+
Applies to grid, flex, and block layouts.
1203+
Creates a reading flow container,
1204+
and enables the use of the 'reading-order' property on direct children.
1205+
Other than respecting the 'reading-order' property,
1206+
follows the order of elements in the DOM.
12001207
<dt><dfn>flex-visual</dfn>
12011208
<dd>
12021209
Only takes effect on flex containers.
@@ -1324,7 +1331,7 @@ ISSUE(9922): Should this property also apply to tables?
13241331
Name: reading-order
13251332
Value: <<integer>>
13261333
Initial: 0
1327-
Applies to: Direct children of a reading flow container
1334+
Applies to: Direct block-level, grid item, or flex item children of a reading flow container.
13281335
Inherited: no
13291336
Computed value: specified integer
13301337
Animation type: by computed value type
@@ -1370,6 +1377,31 @@ ISSUE(9922): Should this property also apply to tables?
13701377
</pre>
13711378
</div>
13721379

1380+
<div class='example'>
1381+
In this example there are five direct block-level children of a block container
1382+
where 'reading-flow' has a value of ''source-order''.
1383+
The third item has a 'reading-order' value of '-1'.
1384+
The reading flow visits the third item first, then the rest in source order.
1385+
1386+
<pre class="lang-markup">
1387+
&lt;div class="wrapper"&gt;
1388+
&lt;a href="#"&gt;Item 1&lt;/a&gt;
1389+
&lt;a href="#"&gt;Item 2&lt;/a&gt;
1390+
&lt;a href="#"&gt;Item 3&lt;/a&gt;
1391+
&lt;a href="#"&gt;Item 4&lt;/a&gt;
1392+
&lt;a href="#"&gt;Item 5&lt;/a&gt;
1393+
&lt;/div&gt;
1394+
</pre>
1395+
1396+
<pre class="lang-css">
1397+
.wrapper { reading-flow: source-order; }
1398+
1399+
.wrapper > a { display: block; }
1400+
1401+
.wrapper a:nth-child(3){ reading-order: -1; }
1402+
</pre>
1403+
</div>
1404+
13731405
Advisement: The source document should express
13741406
the underlying logical order of elements.
13751407
The 'reading-flow' and 'reading-order' properties exist for cases where a given document

0 commit comments

Comments
 (0)