@@ -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'>
290300Grid 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