@@ -1014,9 +1014,7 @@ Display Order Shorthand: the 'order' property</h3>
10141014 <pre class='propdef shorthand'>
10151015 Name : order
10161016 Value : [ <<'layout-order'>> <<'reading-order'>>? ] |
1017- [ reading && <<'reading-order'>> ] |
1018- [ layout && <<'layout-order'>> ] |
1019- [ reading-and-layout && <<integer>> ]
1017+ [ [ reading || layout ] && <<integer>> ]
10201018 Applies to : [=flex items=] and [=grid items=]
10211019 Inherited : no
10221020 </pre>
@@ -1038,9 +1036,34 @@ Display Order Shorthand: the 'order' property</h3>
10381036
10391037 The 'order' property sets both 'layout-order' and 'reading-order'
10401038 in a single declaration.
1041- Unless <dfn value for=order>reading-and-layout</dfn> is specified--
1042- in which case both <<'reading-order'>> and <<'layout-order'>> are set to the specified <<integer>> value--
1043- the omitted [=longhand=] is <em> set to zero</em> .
1039+ Values have the following meanings:
1040+
1041+ <dl dfn-for=order dfn-type=value>
1042+ <dt> <dfn><<integer>></dfn>
1043+ <dd>
1044+ If one integer and no keyword is specified,
1045+ then sets 'layout-order' to the specified integer,
1046+ and sets 'reading-order' to its [=initial value=] .
1047+ If two integers are specified,
1048+ the first sets 'layout-order' and the second sets 'reading-order' .
1049+ Otherwise sets the appropriate [=longhand=] (s) to the specified integer(s).
1050+
1051+ <dt> <dfn>layout</dfn>
1052+ <dd>
1053+ Indicates setting 'layout-order' to the specified integer.
1054+ If ''reading'' is not specified,
1055+ 'reading-order' is set to its [=initial value=] .
1056+
1057+ <dt> <dfn>reading</dfn>
1058+ <dd>
1059+ Indicates setting 'reading-order' to the specified integer.
1060+ If ''layout'' is not specified,
1061+ 'layout-order' is set to its [=initial value=] .
1062+ </dl>
1063+
1064+ Note: The single-integer syntax sets only 'layout-order' ,
1065+ in order to enable rearranging layout for better visual display
1066+ without changing the underlying reading order.
10441067
10451068 <div class='example'>
10461069 Here's an example of a catalog item card
@@ -1189,7 +1212,7 @@ Box Order: the 'layout-order' property</h3>
11891212 Specifically, the 'layout-order' property controls the order in which
11901213 [=flex items=] or [=grid items=] appear within their container
11911214 by assigning them to the ordinal groups,
1192- as specified by its <dfn value for=order><<integer>></dfn> value.
1215+ as specified by its <dfn value for=layout- order><<integer>></dfn> value.
11931216
11941217 [=flex container|Flex=] and [=grid containers=] then lay out their contents
11951218 in <dfn export>order-modified document order</dfn> ,
0 commit comments