Skip to content

Commit 40f27e6

Browse files
committed
[css-grid] First cut, a11y warnings on grid placement.
1 parent abbb4bb commit 40f27e6

2 files changed

Lines changed: 95 additions & 28 deletions

File tree

css-grid/Overview.bs

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -285,6 +285,16 @@ Source-Order Independence</h3>
285285
</pre>
286286
</div>
287287

288+
Note: The reordering capabilities of grid layout intentionally affect
289+
<em>only the visual rendering</em>,
290+
leaving speech order and navigation based on the source order.
291+
This allows authors to manipulate the visual presentation
292+
while leaving the source order intact and optimized for non-CSS UAs
293+
and for linear models such as speech and sequential navigation.
294+
295+
Advisement: Grid item placement and reordering must not be used
296+
as a substitute for correct source ordering,
297+
as that can ruin the accessibility of the document.
288298

289299
<h3 id='grid-layering'>
290300
Grid Layering of Elements</h3>
@@ -2354,6 +2364,33 @@ Auto Sizing Subgrids</h4>
23542364
The above example would auto-place the <code>.adverts</code> block,
23552365
if no further rules specified its position.
23562366

2367+
<h3 id="placement-a11y">
2368+
Grid Item Placement vs. Source Order</h3>
2369+
2370+
<blockquote>
2371+
<p>“With great power comes great responsibility.”
2372+
</blockquote>
2373+
2374+
The abilities of the <a>grid-placement properties</a>
2375+
allow content to be freely arranged and reordered within the <a>grid</a>,
2376+
such that the visual presentation can be largely disjoint
2377+
from the underlying source order.
2378+
These abilities allow the author great freedom
2379+
in tailoring the rendering to different devices
2380+
and modes of presentation
2381+
e.g. using <a>media queries</a>.
2382+
However <strong>they are not a substitute for correct source ordering</strong>.
2383+
2384+
Correct source order is important for speech,
2385+
for sequential navigation (such as keyboard navigation),
2386+
and non-CSS UAs such as search engines, tactile browsers, etc.
2387+
Grid placement <em>only</em> affects the visual presentation!
2388+
This allows authors to optimize the document source for
2389+
non-CSS/non-visual interaction modes,
2390+
and use grid placement techniques to further manipulate the visual presentation
2391+
so as to leave that source order intact.
2392+
2393+
23572394
<!--
23582395
██████ ████████ ████ ████████ ████████ ███████ ██ ██ ██████ ████████ ███ ████████ ████████
23592396
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██

0 commit comments

Comments
 (0)