@@ -1166,7 +1166,7 @@ Reordering and Accessibility</h3>
1166
1166
<h2 id='reading-flow'>
1167
1167
Reading Order: the 'reading-flow' property</h2>
1168
1168
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
1170
1170
with a valid 'reading-flow' value other than ''normal'' .
1171
1171
1172
1172
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?
1179
1179
1180
1180
<pre class='propdef'>
1181
1181
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
1183
1183
Initial : normal
1184
- Applies to : flex and grid containers
1184
+ Applies to : block, flex and grid containers
1185
1185
Inherited : no
1186
1186
Computed value : as specified
1187
1187
Animation type : not animatable
1188
1188
</pre>
1189
1189
1190
1190
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
1192
1192
or are navigated to when using (linear) sequential navigation methods.
1193
1193
1194
1194
It takes one keyword value. Values are defined as follows:
@@ -1197,6 +1197,13 @@ ISSUE(9922): Should this property also apply to tables?
1197
1197
<dt> <dfn>normal</dfn>
1198
1198
<dd>
1199
1199
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.
1200
1207
<dt> <dfn>flex-visual</dfn>
1201
1208
<dd>
1202
1209
Only takes effect on flex containers.
@@ -1324,7 +1331,7 @@ ISSUE(9922): Should this property also apply to tables?
1324
1331
Name : reading-order
1325
1332
Value : <<integer>>
1326
1333
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.
1328
1335
Inherited : no
1329
1336
Computed value : specified integer
1330
1337
Animation type : by computed value type
@@ -1370,6 +1377,31 @@ ISSUE(9922): Should this property also apply to tables?
1370
1377
</pre>
1371
1378
</div>
1372
1379
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
+ <div class="wrapper">
1388
+ <a href="#">Item 1</a>
1389
+ <a href="#">Item 2</a>
1390
+ <a href="#">Item 3</a>
1391
+ <a href="#">Item 4</a>
1392
+ <a href="#">Item 5</a>
1393
+ </div>
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
+
1373
1405
Advisement: The source document should express
1374
1406
the underlying logical order of elements.
1375
1407
The 'reading-flow' and 'reading-order' properties exist for cases where a given document
0 commit comments