@@ -1166,7 +1166,7 @@ Reordering and Accessibility</h3>
11661166<h2 id='reading-flow'>
11671167Reading 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
11701170with a valid 'reading-flow' value other than ''normal'' .
11711171
11721172The <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+ <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+
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