diff --git a/css-sizing-3/Overview.bs b/css-sizing-3/Overview.bs index 4ffa28be7e8..e8583d2fad3 100644 --- a/css-sizing-3/Overview.bs +++ b/css-sizing-3/Overview.bs @@ -53,6 +53,8 @@ Module interactions

This module extends the 'width', 'height', 'min-width', 'min-height', 'max-width', 'max-height', and 'column-width' features defined in [[!CSS2]] chapter 10 and in [[!CSS3COL]] +

The definition of the 'box-sizing' property in module supersedes the one in [[CSS-UI-3]]. +

Values

@@ -508,7 +510,7 @@ Containing or Excluding Floats ████████ ███████ ██ ██ ██████ ████ ████████ ████ ██ ██ ██████ --> -

+

Box Edges for Sizing: the 'box-sizing' property

@@ -620,22 +622,67 @@ Box Edges for Sizing: the 'box-sizing' property +
+ This example uses box-sizing to evenly horizontally split + two divs with fixed size borders inside a div container, + which would otherwise require additional markup. + + sample CSS: +

+		div.container {
+			width:38em;
+			border:1em solid black;
+		}
+
+		div.split {
+			box-sizing:border-box;
+			width:50%;
+			border:1em silver ridge;
+			float:left;
+		}
+		
+ + sample HTML fragment: +

+		<div class="container">
+		<div class="split">This div occupies the left half.</div>
+		<div class="split">This div occupies the right half.</div>
+		</div>
+		
+ + demonstration of sample CSS and HTML: +
This div should occupy the left half.
This div should occupy the right half.
The two divs above should appear side by side, each (including borders) 50% of the content width of their container. If instead they are stacked one on top of the other then your browser does not support 'box-sizing'.
+
+ Note: Certain HTML elements, such as <{button}>, default to ''border-box'' behavior. See HTML for details on which elements have this behavior. - In the CSS specifications, + In legacy CSS specifications, the terms width, height, minimum (min) width, minimum (min) height, maximum (max) width, and maximum (max) height - refer to the inner size + generally refer to the inner size (content-box size) of a box unless otherwise indicated. + Refer to [[CSS-UI-3#box-sizing]] for an explicit disambiguation of these terms + for the Visual formatting model details section of [[CSS2]]. + +
To avoid ambiguities, + specification authors should avoid ambiguous uses of terms such as width or height without further qualification, + and should explicitely refer and link to + the inner size, + the outer size, + the size of the border-box, + the computed value of the sizing properties, + etc, + as appropriate for each case. +