Skip to content

Commit e39daf7

Browse files
committed
[css-grid] Editorial tweaks to overview
1 parent 735d306 commit e39daf7

1 file changed

Lines changed: 25 additions & 19 deletions

File tree

css-grid/Overview.bs

Lines changed: 25 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,8 @@ Introduction</h2>
135135
<h2 id='overview'>
136136
Overview</h2>
137137

138+
<em>This section is not normative.</em>
139+
138140
Grid Layout controls the layout of its content
139141
through the use of a <a>grid</a>:
140142
an intersecting set of horizontal and vertical lines
@@ -301,6 +303,7 @@ Sizing the Grid</h3>
301303
Finally each <a>grid item</a> is sized and aligned within its assigned <a>grid area</a>,
302304
as specified by its own sizing and alignment properties.
303305

306+
304307
<h3 id='background'>
305308
Background and Motivation</h3>
306309

@@ -323,11 +326,15 @@ Background and Motivation</h3>
323326
It provides a mechanism for authors to divide available space for layout into columns and rows
324327
using a set of predictable sizing behaviors.
325328
Authors can then precisely position and size the building block elements of their application
326-
into <a>grid areas</a> defined by the intersection of these columns and rows.
327-
Figure 1 illustrates a basic layout which can be achieved with grid layout.
329+
into the <a>grid areas</a> defined by the intersections of these columns and rows.
330+
331+
<h3 id="overview-examples">
332+
Sample Use Cases</h3>
328333

329-
<h3 id='adapting-to-available-space'>
330-
Adapting Layouts to Available Space</h3>
334+
<em>This section is not normative.</em>
335+
336+
<h4 id='adapting-to-available-space'>
337+
Adapting Layouts to Available Space</h4>
331338

332339
<figure class="sidefigure">
333340
<img alt="Image: Five grid items arranged according to content size and available space." src="images/game-smaller.png" />
@@ -341,8 +348,8 @@ Adapting Layouts to Available Space</h3>
341348
<figcaption>Growth in the grid due to an increase in available space.</figcaption>
342349
</figure>
343350

344-
Grid layout can be used to intelligently reflow elements within a webpage.
345-
Figure 2 and 3 represents a game with five major components in the layout:
351+
Grid layout can be used to intelligently resize elements within a webpage.
352+
The figures above represent a game with five major components in the layout:
346353
the game title, stats area, game board, score area, and control area.
347354
The author's intent is to divide the space for the game such that:
348355

@@ -356,7 +363,7 @@ Adapting Layouts to Available Space</h3>
356363
<li>
357364
The bottom of the game board and bottom of the stats area align when the game has reached its minimum height.
358365
In all other cases the game board will stretch to take advantage of all the space available to it.
359-
<li>
366+
<li>
360367
The controls are centered under the game board.
361368
<li>
362369
The top of the score area is aligned to the top of the controls area.
@@ -366,15 +373,15 @@ Adapting Layouts to Available Space</h3>
366373
The score area is aligned to the controls beneath the stats are.
367374
</ul>
368375

369-
The following example shows how an author might achieve all the sizing, placement, and alignment rules declaratively.
376+
The following grid layout example shows how an author might achieve
377+
all the sizing, placement, and alignment rules declaratively.
370378

371379

372380
<div class="example">
373381
<pre class="lang-css">
374382
/**
375-
* This example illustrates one that an author may use to define the position and space for each <a>grid item</a>
376-
* using the 'grid-template-rows' and 'grid-template-columns' properties on the <a>grid container</a>,
377-
* and the 'grid-row' and 'grid-column' properties on each <a>grid item</a>.
383+
* Define the space for each <a>grid item</a> by declaring the grid
384+
* on the <a>grid container</a>.
378385
*/
379386
#grid {
380387
/**
@@ -401,10 +408,9 @@ Adapting Layouts to Available Space</h3>
401408
/* 5 */ auto;
402409
}
403410

404-
/* Each part of the game is positioned between grid lines. It's achieved by
405-
* referencing the starting grid line and then specifying, if more
406-
* than one, the number of rows or columns spanned to determine
407-
* the ending grid line, which establishes bounds for the area. */
411+
/* Specify the position of each <a>grid item</a> using coordinates on
412+
* the 'grid-row' and 'grid-column' properties of each <a>grid item</a>.
413+
*/
408414
#title { grid-column: 1; grid-row: 1; }
409415
#score { grid-column: 1; grid-row: 3; }
410416
#stats { grid-column: 1; grid-row: 2; align-self: start; }
@@ -427,8 +433,8 @@ Adapting Layouts to Available Space</h3>
427433
and to position and size <a>grid items</a>,
428434
each optimized for different scenarios.
429435

430-
<h3 id='source-independence'>
431-
Source-Order Independence</h3>
436+
<h4 id='source-independence'>
437+
Source-Order Independence</h4>
432438

433439
<figure class="sidefigure">
434440
<img alt="Image: An arrangement suitable for portrait orientation." src="images/game-portrait.png" />
@@ -523,8 +529,8 @@ Source-Order Independence</h3>
523529
as a substitute for correct source ordering,
524530
as that can ruin the accessibility of the document.
525531

526-
<h3 id='grid-layering'>
527-
Grid Layering of Elements</h3>
532+
<h4 id='grid-layering'>
533+
Grid Layering of Elements</h4>
528534

529535
<figure class="sidefigure">
530536
<img alt="Image: A control composed of layered HTML elements." src="images/control-layering-and-alignment.png" />

0 commit comments

Comments
 (0)