Skip to content

Commit c0ce082

Browse files
committed
[css-display-4] Inline background logic from issue into a note #7387
1 parent 016dd8d commit c0ce082

File tree

1 file changed

+39
-7
lines changed

1 file changed

+39
-7
lines changed

css-display-4/Overview.bs

+39-7
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)