Skip to content

Commit 3a1c2a8

Browse files
committed
[css-box] Add subheadings, export <box>, update to css-box-4
1 parent 1752d4e commit 3a1c2a8

File tree

2 files changed

+35
-19
lines changed

2 files changed

+35
-19
lines changed

css-box-3/Overview.bs

+16-8
Original file line numberDiff line numberDiff line change
@@ -131,11 +131,21 @@ The CSS Box Model {#box-model}
131131
<p class="caption">The various areas and edges of a typical box.
132132
</div>
133133

134+
The background of the content, padding, and border areas of a box
135+
is specified by its 'background' properties.
136+
The border area can additionally be painted with a border style
137+
using the 'border' properties.
138+
Margins are always transparent.
139+
See [[css-backgrounds-3]].
140+
134141
The margin, border, and padding can be broken down into
135142
top, right, bottom, and left segments,
136143
each of which can be controlled independently
137144
by its corresponding property.
138145

146+
Boxes and Edges {#box-edges}
147+
---------------
148+
139149
The perimeter of each of the four areas
140150
(content, padding, border, and margin)
141151
is called an <dfn export lt="box edge | edge" for="box">edge</dfn>,
@@ -192,12 +202,8 @@ The CSS Box Model {#box-model}
192202
and <a>margin areas</a>.
193203
</dl>
194204

195-
The background of the content, padding, and border areas of a box
196-
is specified by its 'background' properties.
197-
The border area can additionally be painted with a border style
198-
using the 'border' properties.
199-
Margins are always transparent.
200-
See [[css-backgrounds-3]].
205+
Fragmentation {#fragmentation}
206+
-------------
201207

202208
When a box <a href="https://www.w3.org/TR/css-break-3/#fragmentation-model">fragments</a>--
203209
is broken, as across lines or across pages, into separate <a>box fragments</a>--
@@ -211,7 +217,7 @@ The CSS Box Model {#box-model}
211217
Box-edge Keywords {#keywords}
212218
-----------------
213219

214-
The following <dfn noexport>&lt;box></dfn> CSS keywords are defined for use
220+
The following <dfn><<box>></dfn> CSS keywords are defined for use
215221
in properties (such as 'transform-box' and 'background-clip')
216222
that need to refer to various box edges:
217223

@@ -265,7 +271,9 @@ Box-edge Keywords {#keywords}
265271
See https://github.com/w3c/csswg-drafts/issues/4662 -->
266272
</dl>
267273

268-
For convenience, the following value types are defined:
274+
For convenience, the following value types are defined
275+
to represents commonly used subsets of <<box>>:
276+
269277
<pre class="prod">
270278
<dfn><<visual-box>></dfn> = content-box | padding-box | border-box
271279
<dfn><<layout-box>></dfn> = <<visual-box>> | margin-box

css-box-4/Overview.bs

+19-11
Original file line numberDiff line numberDiff line change
@@ -117,11 +117,21 @@ The CSS Box Model {#box-model}
117117
<p class="caption">The various areas and edges of a typical box.
118118
</div>
119119

120+
The background of the content, padding, and border areas of a box
121+
is specified by its 'background' properties.
122+
The border area can additionally be painted with a border style
123+
using the 'border' properties.
124+
Margins are always transparent.
125+
See [[css-backgrounds-3]].
126+
120127
The margin, border, and padding can be broken down into
121128
top, right, bottom, and left segments,
122129
each of which can be controlled independently
123130
by its corresponding property.
124131

132+
Boxes and Edges {#box-edges}
133+
---------------
134+
125135
The perimeter of each of the four areas
126136
(content, padding, border, and margin)
127137
is called an <dfn export lt="box edge | edge" for="box">edge</dfn>,
@@ -178,26 +188,22 @@ The CSS Box Model {#box-model}
178188
and <a>margin areas</a>.
179189
</dl>
180190

181-
The background of the content, padding, and border areas of a box
182-
is specified by its 'background' properties.
183-
The border area can additionally be painted with a border style
184-
using the 'border' properties.
185-
Margins are always transparent.
186-
See [[css-backgrounds-3]].
191+
Fragmentation {#fragmentation}
192+
-------------
187193

188-
When a box <a href="https://www.w3.org/TR/css-break-3/#fragmentation-model">fragments</a>--
194+
When a box <a href="https://www.w3.org/TR/css-break-4/#fragmentation-model">fragments</a>--
189195
is broken, as across lines or across pages, into separate <a>box fragments</a>--
190196
each of its boxes
191197
(<a>content box</a>, <a>padding box</a>, <a>border box</a>, <a>margin box</a>)
192198
also fragments.
193199
How the content/padding/border/margin areas react to fragmentation
194-
is specified in [[css-break-3]]
200+
is specified in [[css-break-4]]
195201
and controlled by the 'box-decoration-break' property.
196202

197203
Box-edge Keywords {#keywords}
198204
-----------------
199205

200-
The following <dfn noexport>&lt;box></dfn> CSS keywords are defined for use
206+
The following <dfn><<box>></dfn> CSS keywords are defined for use
201207
in properties (such as 'transform-box' and 'background-clip')
202208
that need to refer to various box edges:
203209

@@ -250,7 +256,9 @@ Box-edge Keywords {#keywords}
250256
See https://github.com/w3c/csswg-drafts/issues/4662 -->
251257
</dl>
252258

253-
For convenience, the following value types are defined:
259+
For convenience, the following value types are defined
260+
to represents commonly used subsets of <<box>>:
261+
254262
<pre class="prod">
255263
<dfn><<visual-box>></dfn> = content-box | padding-box | border-box
256264
<dfn><<layout-box>></dfn> = <<visual-box>> | margin-box
@@ -278,7 +286,7 @@ Margins {#margins}
278286
See <a href="https://www.w3.org/TR/CSS2/box.html#collapsing-margins">CSS2&sect;8.3.1 Collapsing Margins</a>
279287
for details.
280288
Also, margins adjoining a <a>fragmentation break</a> are sometimes truncated.
281-
See [[css-break-3#break-margins]] for details.
289+
See [[css-break-4#break-margins]] for details.
282290

283291
Page-relative (Physical) Margin Properties: the 'margin-top', 'margin-right', 'margin-bottom', and 'margin-left' properties {#margin-physical}
284292
-------------------------------------------

0 commit comments

Comments
 (0)