8000 [css2] Generated. Do not edit! · w3c/csswg-drafts@eb10fba · GitHub
Skip to content

Commit eb10fba

Browse files
committed
[css2] Generated. Do not edit!
--HG-- extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%402992
1 parent d98cee8 commit eb10fba

4 files changed

Lines changed: 150 additions & 108 deletions

File tree

css2/css2.html

Lines changed: 74 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -7725,7 +7725,7 @@ <h3>9.2.3 <a name="run-in">Run-in boxes</a></h3>
77257725
<li>Let <var>B</var> be the first of <var>A</var>'s following <a
77267726
href="conform.html#sibling">siblings</a> that is neither floating
77277727
nor <a href="visuren.html#absolutely-positioned">absolutely
7728-
positioned nor has 'display: none'. If <var>B</var> exists and has a
7728+
positioned</a> nor has 'display: none'. If <var>B</var> exists and has a
77297729
specified value for 'display' of 'block' or 'list-item' and is not
77307730
<a href="conform.html#replaced-element">replaced,</a> then
77317731
<var>A</var> is rendered as an 'inline' element at the start of
@@ -9470,25 +9470,28 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
94709470

94719471
<p>For a positioned box, the <a href="visuren.html#propdef-z-index" class="noxref"><span
94729472
class="propinst-z-index">'z-index'</span></a> property specifies:
9473-
</p>
9473+
94749474
<ol>
9475-
<li>The stack level of the box in the current stacking context.</li>
9476-
<li>Whether the box establishes a local stacking context.</li>
9475+
<li>The stack level of the box in the current stacking context.
9476+
9477+
<li>Whether the box establishes a stacking context.
94779478
</ol>
94789479

9479-
<p>Values have the following meanings:</p>
9480+
<p>Values have the following meanings:
94809481

94819482
<dl>
9482-
<dt><span class="index-inst" title="&lt;integer&gt;"><a name="x35" href="syndata.html#value-def-integer" class="noxref"><span
9483-
class="value-inst-integer"><strong>&lt;integer&gt;</strong></span></a></span></dt>
9484-
<dd>This integer is the stack level of the generated box
9485-
in the current stacking context. The box
9486-
also establishes a local stacking context in which its stack
9487-
level is '0'.</dd>
9488-
<dt><strong>auto</strong></dt>
9489-
<dd>The stack level of the generated box in the current stacking
9490-
context is the same as its parent's box. The
9491-
box does not establish a new local stacking context.</dd>
9483+
<dt><span class="index-inst" title="&lt;integer&gt;"><a name="x35" href="syndata.html#value-def-integer" class="noxref"><span
9484+
class="value-inst-integer"><strong>&lt;integer&gt;</strong></span></a></span>
9485+
9486+
<dd>This integer is the stack level of the generated box in the
9487+
current stacking context. The box also establishes a new stacking
9488+
context.
9489+
9490+
<dt><strong>auto</strong>
9491+
9492+
<dd>The stack level of the generated box in the current stacking
9493+
context is '0'. The box does not establish a new stacking context
9494+
unless it is the root element.
94929495
</dl>
94939496

94949497
<p><em>In this section, the expression "in front of"
@@ -9508,11 +9511,12 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
95089511
stacking contexts may not come between any of its boxes.
95099512
</p>
95109513
<p>Each box belongs to one <a name="x36"><span class="index-def" title="stacking
9511-
context"><dfn>stacking context</dfn></span></a>. Each box in a given
9512-
stacking context has an integer <span class="index-def" title="stack
9513-
level"><a name="stack-level"><dfn>stack level</dfn></a></span>, which
9514-
is its position on the z-axis relative to other boxes in the same
9515-
stacking context. Boxes with greater stack levels are always formatted
9514+
context"><dfn>stacking context</dfn></span></a>. Each positioned box in a
9515+
given stacking context has an integer <span class="index-def"
9516+
title="stack level"><a name="stack-level"><dfn>stack
9517+
level</dfn></a></span>, which is its position on the z-axis relative
9518+
other stack levels within the same stacking context. Boxes with
9519+
greater stack levels are always formatted
95169520
in front of boxes with lower stack levels. Boxes may have negative
95179521
stack levels. Boxes with the same stack level in a stacking context
95189522
are stacked back-to-front according to document tree order.
@@ -9528,33 +9532,41 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
95289532
href="http://www.w3.org/TR/css3-color/#transparency">opacity</a>'
95299533
<a href="refs.html#ref-CSS3COLOR" rel="biblioentry" class="noxref"><span class="informref">[CSS3COLOR]</span></a>.
95309534
</p>
9531-
<p>
9532-
Each stacking context consists of the following
9533-
stacking levels (from back to front):
9534-
</p>
9535+
9536+
<p>Within each stacking context, the following layers are painted in
9537+
back-to-front order.
9538+
95359539
<ol>
9536-
<li>the background and borders of the element forming the stacking context.</li>
9537-
<li>the stacking contexts of descendants with negative stack
9538-
levels.</li>
9539-
<li>a stacking level containing in-flow non-inline-level
9540-
non-positioned descendants.</li>
9541-
<li>a stacking level for non-positioned floats and their contents.</li>
9542-
<li>a stacking level for in-flow inline-level non-positioned descendants.</li>
9543-
<li>a stacking level for positioned descendants with 'z-index:
9544-
auto', and any descendant stacking contexts with 'z-index: 0'.</li>
9545-
<li>the stacking contexts of descendants with positive stack levels.</li>
9540+
<li>the background and borders of the element forming the stacking
9541+
context.
9542+
9543+
<li>the child stacking contexts with negative stack levels (most
9544+
negative first).
9545+
9546+
<li>the in-flow, non-inline-level, non-positioned descendants.
9547+
9548+
<li>the floating descendants.
9549+
9550+
<li>the in-flow, inline-level, non-positioned descendants, including
9551+
inline tables and inline blocks.
9552+
9553+
<li>the stacking contexts with stack level 0, and the positioned
9554+
descendants with 'z-index: auto'.
9555+
9556+
<li>the child stacking contexts with positive stack levels (least
9557+
positive first).
95469558
</ol>
9547-
<p>
9548-
For a more thorough explanation of the stacking order, please see <a href="zindex.html">Appendix E</a>.
9549-
</p>
9550-
<p>
9551-
The contents of inline blocks and inline tables are stacked as if
9552-
they generated new stacking contexts, except that any positioned
9553-
elements and any elements that
9554-
actually create new stacking contexts take part in the parent
9555-
stacking context. They are then painted atomically in the inline
9556-
stacking level.
9557-
</p>
9559+
9560+
<p>Positioned elements with 'z-index: auto' (in layer&nbsp;6), floats
9561+
(layer&nbsp;4), inline blocks (layer&nbsp;5), and inline tables
9562+
(layer&nbsp;5), are painted as if those elements generated new
9563+
stacking contexts, except that their positioned descendants and any
9564+
child stacking contexts take part in the current stacking context.
9565+
9566+
<p>This painting order is applied recursively to each stacking
9567+
context. This description of stacking context painting order
9568+
constitutes an overview of the detailed normative definition in
9569+
<a href="zindex.html">Appendix&nbsp;E.</a>
95589570

95599571
<div class="html-example">
95609572
<p>In the following example, the stack levels of
@@ -11283,15 +11295,19 @@ <h2>10.8 <a name="line-height">Line height calculations</a>: the <a href="visude
1128311295
</li>
1128411296
<li>The inline boxes are aligned vertically according
1128511297
to their <a href="visudet.html#propdef-vertical-align" class="noxref"><span class="propinst-vertical-align">'vertical-align'</span></a>
11286-
property.
11298+
property.
11299+
11300+
In case they are aligned 'top' or 'bottom', they must be aligned so as
11301+
to minimize the line box height. If such boxes are tall enough, there
11302+
are multiple solutions and CSS&nbsp;2.1 does not define the position
11303+
of the line box's baseline (i.e., the position of the <a
11304+
href="#strut">strut, see below</a>).
1128711305
</li>
1128811306
<li>The line box height is the distance between the uppermost
11289-
box top and the lowermost box bottom.
11307+
box top and the lowermost box bottom. (This includes the <a
11308+
href="#strut">strut,</a> as explained under <a href="visudet.html#propdef-line-height" class="noxref"><span
11309+
class="propinst-line-height">'line-height'</span></a> below.)
1129011310
</li>
11291-
<li>If the resulting height is smaller than the minimal height of line
11292-
boxes for this block, as specified by the <a href="visudet.html#propdef-line-height" class="noxref"><span
11293-
class=propinst-line-height>'line-height'</span></a> property, the height is
11294-
increased to be that minimal height.</li>
1129511311
</ol>
1129611312

1129711313
<p>Empty inline elements generate empty inline boxes, but these boxes
@@ -11367,6 +11383,10 @@ <h3>10.8.1 <a name="leading">Leading and half-leading</a></h3>
1136711383
block's font and line height properties (what T<sub>E</sub>X calls a
1136811384
"strut").</a>
1136911385
</p>
11386+
<p>The height and depth of the font above and below the baseline are
11387+
assumed to be metrics that are contained in the font. (For more
11388+
details, see CSS level&nbsp;3.)
11389+
1137011390
<p>On an <a
1137111391
href="visuren.html#inline-level">inline-level</a> element, 'line-height'
1137211392
specifies the height that is used in the calculation of the line box
@@ -24454,8 +24474,9 @@ <h2>E.2 <a name="painting-order">Painting order</a></h2>
2445424474
and contains the root element. Initially, the viewport is anchored
2445524475
with its top left corner at the canvas origin.
2445624476

24457-
<p>The stacking order for an element generating a stacking context
24458-
(see the 'z-index' property) is:
24477+
<p>The painting order for the descendants of an element generating
24478+
a stacking context (see the <a href="visuren.html#propdef-z-index" class="noxref"><span
24479+
class="propinst-z-index">'z-index'</span></a> property) is:
2445924480

2446024481
<ol class=stack>
2446124482
<li>

css2/visudet.html

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1107,8 +1107,8 @@ <h3>10.6.4 <a name="abs-non-replaced-height">Absolutely positioned, non-replaced
11071107
first box of the element if its specified <a href="visuren.html#propdef-position" class="noxref"><span
11081108
class="propinst-position">'position'</span></a> value had been 'static'
11091109
and its specified <a href="visuren.html#propdef-float" class="noxref"><span class="propinst-float">'float'</span></a> had been
1110-
'none' and <a href="visuren.html#propdef-clear" class="noxref"><span class="propinst-clear">'clear'</span></a> had been
1111-
'none'. (Note that due to the rules
1110+
'none' and its specified <a href="visuren.html#propdef-clear" class="noxref"><span class="propinst-clear">'clear'</span></a>
1111+
had been 'none'. (Note that due to the rules
11121112
in <a href="visuren.html#dis-pos-flo">section&nbsp;9.7</a> this might
11131113
require also assuming a different computed value for 'display'.)
11141114
The value is negative if the hypothetical box is above the containing
@@ -1403,15 +1403,19 @@ <h2>10.8 <a name="line-height">Line height calculations</a>: the <a href="visude
14031403
</li>
14041404
<li>The inline boxes are aligned vertically according
14051405
to their <a href="visudet.html#propdef-vertical-align" class="noxref"><span class="propinst-vertical-align">'vertical-align'</span></a>
1406-
property.
1406+
property.
1407+
1408+
In case they are aligned 'top' or 'bottom', they must be aligned so as
1409+
to minimize the line box height. If such boxes are tall enough, there
1410+
are multiple solutions and CSS&nbsp;2.1 does not define the position
1411+
of the line box's baseline (i.e., the position of the <a
1412+
href="#strut">strut, see below</a>).
14071413
</li>
14081414
<li>The line box height is the distance between the uppermost
1409-
box top and the lowermost box bottom.
1415+
box top and the lowermost box bottom. (This includes the <a
1416+
href="#strut">strut,</a> as explained under <a href="visudet.html#propdef-line-height" class="noxref"><span
1417+
class="propinst-line-height">'line-height'</span></a> below.)
14101418
</li>
1411-
<li>If the resulting height is smaller than the minimal height of line
1412-
boxes for this block, as specified by the <a href="visudet.html#propdef-line-height" class="noxref"><span
1413-
class=propinst-line-height>'line-height'</span></a> property, the height is
1414-
increased to be that minimal height.</li>
14151419
</ol>
14161420

14171421
<p>Empty inline elements generate empty inline boxes, but these boxes
@@ -1487,6 +1491,10 @@ <h3>10.8.1 <a name="leading">Leading and half-leading</a></h3>
14871491
block's font and line height properties (what T<sub>E</sub>X calls a
14881492
"strut").</a>
14891493
</p>
1494+
<p>The height and depth of the font above and below the baseline are
1495+
assumed to be metrics that are contained in the font. (For more
1496+
details, see CSS level&nbsp;3.)
1497+
14901498
<p>On an <a
14911499
href="visuren.html#inline-level">inline-level</a> element, 'line-height'
14921500
specifies the height that is used in the calculation of the line box

css2/visuren.html

Lines changed: 57 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -363,7 +363,7 @@ <h3>9.2.3 <a name="run-in">Run-in boxes</a></h3>
363363
<li>Let <var>B</var> be the first of <var>A</var>'s following <a
364364
href="conform.html#sibling">siblings</a> that is neither floating
365365
nor <a href="visuren.html#absolutely-positioned">absolutely
366-
positioned nor has 'display: none'. If <var>B</var> exists and has a
366+
positioned</a> nor has 'display: none'. If <var>B</var> exists and has a
367367
specified value for 'display' of 'block' or 'list-item' and is not
368368
<a href="conform.html#replaced-element">replaced,</a> then
369369
<var>A</var> is rendered as an 'inline' element at the start of
@@ -2108,25 +2108,28 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
21082108

21092109
<p>For a positioned box, the <a href="visuren.html#propdef-z-index" class="noxref"><span
21102110
class="propinst-z-index">'z-index'</span></a> property specifies:
2111-
</p>
2111+
21122112
<ol>
2113-
<li>The stack level of the box in the current stacking context.</li>
2114-
<li>Whether the box establishes a local stacking context.</li>
2113+
<li>The stack level of the box in the current stacking context.
2114+
2115+
<li>Whether the box establishes a stacking context.
21152116
</ol>
21162117

2117-
<p>Values have the following meanings:</p>
2118+
<p>Values have the following meanings:
21182119

21192120
<dl>
2120-
<dt><span class="index-inst" title="&lt;integer&gt;"><a name="x35" href="syndata.html#value-def-integer" class="noxref"><span
2121-
class="value-inst-integer"><strong>&lt;integer&gt;</strong></span></a></span></dt>
2122-
<dd>This integer is the stack level of the generated box
2123-
in the current stacking context. The box
2124-
also establishes a local stacking context in which its stack
2125-
level is '0'.</dd>
2126-
<dt><strong>auto</strong></dt>
2127-
<dd>The stack level of the generated box in the current stacking
2128-
context is the same as its parent's box. The
2129-
box does not establish a new local stacking context.</dd>
2121+
<dt><span class="index-inst" title="&lt;integer&gt;"><a name="x35" href="syndata.html#value-def-integer" class="noxref"><span
2122+
class="value-inst-integer"><strong>&lt;integer&gt;</strong></span></a></span>
2123+
2124+
<dd>This integer is the stack level of the generated box in the
2125+
current stacking context. The box also establishes a new stacking
2126+
context.
2127+
2128+
<dt><strong>auto</strong>
2129+
2130+
<dd>The stack level of the generated box in the current stacking
2131+
context is '0'. The box does not establish a new stacking context
2132+
unless it is the root element.
21302133
</dl>
21312134

21322135
<p><em>In this section, the expression "in front of"
@@ -2146,11 +2149,12 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
21462149
stacking contexts may not come between any of its boxes.
21472150
</p>
21482151
<p>Each box belongs to one <a name="x36"><span class="index-def" title="stacking
2149-
context"><dfn>stacking context</dfn></span></a>. Each box in a given
2150-
stacking context has an integer <span class="index-def" title="stack
2151-
level"><a name="stack-level"><dfn>stack level</dfn></a></span>, which
2152-
is its position on the z-axis relative to other boxes in the same
2153-
stacking context. Boxes with greater stack levels are always formatted
2152+
context"><dfn>stacking context</dfn></span></a>. Each positioned box in a
2153+
given stacking context has an integer <span class="index-def"
2154+
title="stack level"><a name="stack-level"><dfn>stack
2155+
level</dfn></a></span>, which is its position on the z-axis relative
2156+
other stack levels within the same stacking context. Boxes with
2157+
greater stack levels are always formatted
21542158
in front of boxes with lower stack levels. Boxes may have negative
21552159
stack levels. Boxes with the same stack level in a stacking context
21562160
are stacked back-to-front according to document tree order.
@@ -2166,33 +2170,41 @@ <h3>9.9.1 <a name="z-index">Specifying the stack level</a>: the <a href="visuren
21662170
href="http://www.w3.org/TR/css3-color/#transparency">opacity</a>'
21672171
<a href="refs.html#ref-CSS3COLOR" rel="biblioentry" class="noxref"><span class="informref">[CSS3COLOR]</span></a>.
21682172
</p>
2169-
<p>
2170-
Each stacking context consists of the following
2171-
stacking levels (from back to front):
2172-
</p>
2173+
2174+
<p>Within each stacking context, the following layers are painted in
2175+
back-to-front order.
2176+
21732177
<ol>
2174-
<li>the background and borders of the element forming the stacking context.</li>
2175-
<li>the stacking contexts of descendants with negative stack
2176-
levels.</li>
2177-
<li>a stacking level containing in-flow non-inline-level
2178-
non-positioned descendants.</li>
2179-
<li>a stacking level for non-positioned floats and their contents.</li>
2180-
<li>a stacking level for in-flow inline-level non-positioned descendants.</li>
2181-
<li>a stacking level for positioned descendants with 'z-index:
2182-
auto', and any descendant stacking contexts with 'z-index: 0'.</li>
2183-
<li>the stacking contexts of descendants with positive stack levels.</li>
2178+
<li>the background and borders of the element forming the stacking
2179+
context.
2180+
2181+
<li>the child stacking contexts with negative stack levels (most
2182+
negative first).
2183+
2184+
<li>the in-flow, non-inline-level, non-positioned descendants.
2185+
2186+
<li>the floating descendants.
2187+
2188+
<li>the in-flow, inline-level, non-positioned descendants, including
2189+
inline tables and inline blocks.
2190+
2191+
<li>the stacking contexts with stack level 0, and the positioned
2192+
descendants with 'z-index: auto'.
2193+
2194+
<li>the child stacking contexts with positive stack levels (least
2195+
positive first).
21842196
</ol>
2185-
<p>
2186-
For a more thorough explanation of the stacking order, please see <a href="zindex.html">Appendix E</a>.
2187-
</p>
2188-
<p>
2189-
The contents of inline blocks and inline tables are stacked as if
2190-
they generated new stacking contexts, except that any positioned
2191-
elements and any elements that
2192-
actually create new stacking contexts take part in the parent
2193-
stacking context. They are then painted atomically in the inline
2194-
stacking level.
2195-
</p>
2197+
2198+
<p>Positioned elements with 'z-index: auto' (in layer&nbsp;6), floats
2199+
(layer&nbsp;4), inline blocks (layer&nbsp;5), and inline tables
2200+
(layer&nbsp;5), are painted as if those elements generated new
2201+
stacking contexts, except that their positioned descendants and any
2202+
child stacking contexts take part in the current stacking context.
2203+
2204+
<p>This painting order is applied recursively to each stacking
2205+
context. This description of stacking context painting order
2206+
constitutes an overview of the detailed normative definition in
2207+
<a href="zindex.html">Appendix&nbsp;E.</a>
21962208

21972209
<div class="html-example">
21982210
<p>In the following example, the stack levels of

css2/zindex.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,9 @@ <h2>E.2 <a name="painting-order">Painting order</a></h2>
7878
and contains the root element. Initially, the viewport is anchored
7979
with its top left corner at the canvas origin.
8080

81-
<p>The stacking order for an element generating a stacking context
82-
(see the 'z-index' property) is:
81+
<p>The painting order for the descendants of an element generating
82+
a stacking context (see the <a href="visuren.html#propdef-z-index" class="noxref"><span
83+
class="propinst-z-index">'z-index'</span></a> property) is:
8384

8485
<ol class=stack>
8586
<li>

0 commit comments

Comments
 (0)