@@ -978,13 +978,45 @@ Display Order</h2>
978978 Advisement: Author-facing documentation such as tutorials and references
979979 should adequately address the accessibility impacts
980980 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
9881020 so that authors (even authors who don't usually write JS)
9891021 can easily perform source order reordering when necessary
9901022 instead of misusing 'order' .
0 commit comments