Skip to content

Commit 8eaf5f1

Browse files
committed
[css-display-3][css-display-4][editorial] Use “layout order” rather than “visual order”
1 parent c0ce082 commit 8eaf5f1

File tree

2 files changed

+18
-18
lines changed

2 files changed

+18
-18
lines changed

css-display-3/Overview.bs

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1010,7 +1010,7 @@ Display Order: the 'order' property</h2>
10101010
flex-flow: column;
10111011
}
10121012
article.sale-item > img {
1013-
order: -1; /* Shift image before other content (in visual order) */
1013+
order: -1; /* Shift image before other content (in layout order) */
10141014
align-self: center;
10151015
}
10161016
</pre>
@@ -1096,24 +1096,24 @@ Reordering and Accessibility</h3>
10961096
(such as cycling through links, see e.g. <a href="https://html.spec.whatwg.org/multipage/interaction.html#attr-tabindex"><code>tabindex</code></a> [[HTML]]).
10971097

10981098
Advisement:
1099-
Authors <em>must</em> use 'order' only for visual, not logical, reordering of content.
1099+
Authors <em>must</em> use 'order' only for spatial, not logical, reordering of content.
11001100
Style sheets that use 'order' to perform logical reordering are non-conforming.
11011101

11021102
Note: This is so that non-visual media and non-CSS UAs,
11031103
which typically present content linearly,
11041104
can rely on a logical source order,
1105-
while 'order' is used to tailor the visual order.
1105+
while 'order' is used to tailor the layout order.
11061106
(Since visual perception is two-dimensional and non-linear,
1107-
the desired visual order is not always logical.)
1107+
the desired layout order is not always logical.)
11081108

11091109
In order to preserve the author's intended ordering in all presentation modes,
11101110
authoring tools--
11111111
including WYSIWYG editors as well as Web-based authoring aids--
11121112
must reorder the underlying document source
11131113
and not use 'order' to perform reordering
1114-
unless the author has explicitly indicated that the underlying
1115-
document order (which determines speech and navigation order) should be
1116-
<em>out-of-sync</em> with the visual order.
1114+
unless the author has explicitly indicated that
1115+
the spatial order should be <em>out-of-sync</em> with
1116+
the underlying document order (which determines speech and navigation order).
11171117

11181118
<div class="example">
11191119
For example, a tool might offer both drag-and-drop reordering of flex items
@@ -1122,11 +1122,11 @@ Reordering and Accessibility</h3>
11221122
Since most of the time, reordering should affect all screen ranges
11231123
as well as navigation and speech order,
11241124
the tool would perform drag-and-drop reordering at the DOM layer.
1125-
In some cases, however, the author may want different visual orderings per screen size.
1125+
In some cases, however, the author may want different layouts per screen size.
11261126
The tool could offer this functionality by using 'order' together with media queries,
11271127
but also tie the smallest screen size's ordering to the underlying DOM order
11281128
(since this is most likely to be a logical linear presentation order)
1129-
while using 'order' to determine the visual presentation order in other size ranges.
1129+
while using 'order' to define the visual presentation order in other size ranges.
11301130

11311131
This tool would be conformant, whereas a tool that only ever used 'order'
11321132
to handle drag-and-drop reordering

css-display-4/Overview.bs

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1070,7 +1070,7 @@ Display Order Shorthand: the 'order' property</h3>
10701070
flex-flow: column;
10711071
}
10721072
article.sale-item > img {
1073-
order: -1; /* Shift image before other content (in visual order) */
1073+
order: -1; /* Shift image before other content (in layout order) */
10741074
align-self: center;
10751075
}
10761076
</pre>
@@ -1239,24 +1239,24 @@ Reordering and Accessibility</h3>
12391239
(such as cycling through links, see e.g. <a href="https://html.spec.whatwg.org/multipage/interaction.html#attr-tabindex"><code>tabindex</code></a> [[HTML]]).
12401240

12411241
Advisement:
1242-
Authors <em>must</em> use 'layout-order' only for visual, not logical, reordering of content.
1242+
Authors <em>must</em> use 'layout-order' only for spatial, not logical, reordering of content.
12431243
Style sheets that use 'layout-order' to perform logical reordering are non-conforming.
12441244

12451245
Note: This is so that non-visual media and non-CSS UAs,
12461246
which typically present content linearly,
12471247
can rely on a logical source order,
1248-
while 'layout-order' is used to tailor the visual order.
1248+
while 'layout-order' is used to tailor the layout order.
12491249
(Since visual perception is two-dimensional and non-linear,
1250-
the desired visual order is not always logical.)
1250+
the desired layout order is not always logical.)
12511251

12521252
In order to preserve the author's intended ordering in all presentation modes,
12531253
authoring tools--
12541254
including WYSIWYG editors as well as Web-based authoring aids--
12551255
must reorder the underlying document source
12561256
and not use 'layout-order' to perform reordering
1257-
unless the author has explicitly indicated that the underlying
1258-
document order (which determines speech and navigation order) should be
1259-
<em>out-of-sync</em> with the visual order.
1257+
unless the author has explicitly indicated that
1258+
the spatial order should be <em>out-of-sync</em> with
1259+
the underlying document order (which determines speech and navigation order).
12601260

12611261
<div class="example">
12621262
For example, a tool might offer both drag-and-drop reordering of flex items
@@ -1265,11 +1265,11 @@ Reordering and Accessibility</h3>
12651265
Since most of the time, reordering should affect all screen ranges
12661266
as well as navigation and speech order,
12671267
the tool would perform drag-and-drop reordering at the DOM layer.
1268-
In some cases, however, the author may want different visual orderings per screen size.
1268+
In some cases, however, the author may want different layouts per screen size.
12691269
The tool could offer this functionality by using 'order' together with media queries,
12701270
but also tie the smallest screen size's ordering to the underlying DOM order
12711271
(since this is most likely to be a logical linear presentation order)
1272-
while using 'order' to determine the visual presentation order in other size ranges.
1272+
while using 'order' to define the visual presentation order in other size ranges.
12731273

12741274
This tool would be conformant, whereas a tool that only ever used 'order'
12751275
to handle drag-and-drop reordering

0 commit comments

Comments
 (0)