@@ -978,13 +978,45 @@ Display Order</h2>
978
978
Advisement: Author-facing documentation such as tutorials and references
979
979
should adequately address the accessibility impacts
980
980
of 'order' , 'layout-order' , and 'reading-order'
981
- and discourage their misuse.
982
-
983
- ISSUE(7387): See this
984
- <a href="https://github.com/w3c/csswg-drafts/issues/7387#issuecomment-1217193918">
985
- summary of how this all fits together and why</a> .
986
-
987
- ISSUE: DOM needs a convenient reordering function
981
+ and discourage their misuse by authors and authoring tools.
982
+
983
+ <details class="note">
984
+ <summary> Design Considerations and Background</summary>
985
+
986
+ Some of the considerations that went into the design
987
+ of 'order' , 'reading-order' , and 'layout-order' are:
988
+
989
+ * There are clear use cases for disconnecting
990
+ the [=reading and navigation order=] from the box layout order,
991
+ the most fundamental of which is to make sure
992
+ the [=reading and navigation order=] matches the <strong> visual perception order</strong>
993
+ when it is not the same as the box layout order.
994
+ (Visual perception is non-linear, and is influenced by things like
995
+ the size, color contrast, and spacing of a visual element,
996
+ not just its spatial coordinates on the page.)
997
+ * It is a <a href="https://www.w3.org/TR/webarch/#pci">core principle of Web platform architecture</a> ,
998
+ in order to allow content to be accessible to the widest possible audience
999
+ across devices that exist now and in the future,
1000
+ for the underlying document to be sensical independent of CSS.
1001
+ Therefore the underlying document order
1002
+ should represent a logical ordering of its elements
1003
+ regardless of its visual presentation.
1004
+ * For components of a page that do not have a strong inherent order,
1005
+ a document can have multiple visual presentations with different layouts,
1006
+ all conveying the same semantic information.
1007
+ It should be possible for all of these presentations to have good accessibility.
1008
+ * Linear navigation, focus sequencing order, and screen-reader order
1009
+ should always match, because there are users who use them together.
1010
+ * Each component or hierarchical level of a page
1011
+ can have different requirements for reordering,
1012
+ so CSS reordering controls should not lend themselves
1013
+ too easily to blanket use
1014
+ (like 'box-sizing' )
1015
+ rather than tailored use
1016
+ (like <a href="https://www.w3.org/TR/css-logical/">flow-relative vs. physical properties and values</a> ).
1017
+ </details>
1018
+
1019
+ ISSUE(7387): DOM needs a convenient reordering function
988
1020
so that authors (even authors who don't usually write JS)
989
1021
can easily perform source order reordering when necessary
990
1022
instead of misusing 'order' .
0 commit comments