[css3-page] Define the default stacking order of page-margin boxes.
authorSimon Sapin <simon.sapin@exyr.org>
Thu, 07 Mar 2013 17:13:37 +0100
changeset 76772a3f835f72e3
parent 7676 48ca1db78135
child 7678 8948aa9a04e2
[css3-page] Define the default stacking order of page-margin boxes.

WG resolution:
http://lists.w3.org/Archives/Public/www-style/2013Mar/0157.html
http://lists.w3.org/Archives/Public/www-style/2013Mar/0163.html
css3-page/Overview.html
css3-page/Overview.src.html
     1.1 --- a/css3-page/Overview.html	Thu Mar 07 16:54:20 2013 +0100
     1.2 +++ b/css3-page/Overview.html	Thu Mar 07 17:13:37 2013 +0100
     1.3 @@ -9,7 +9,7 @@
     1.4     rel=dcterms.rights>
     1.5    <meta content=" CSS Paged Media Module Level 3" name=dcterms.title>
     1.6    <meta content=text name=dcterms.type>
     1.7 -  <meta content=2013-03-06 name=dcterms.issued>
     1.8 +  <meta content=2013-03-07 name=dcterms.issued>
     1.9    <meta content="Melinda Grant" name=dcterms.creator>
    1.10    <meta content="Håkon Wium Lie" name=dcterms.creator>
    1.11    <meta content="Elika J. Etemad" name=dcterms.creator>
    1.12 @@ -100,7 +100,7 @@
    1.13      <h1 class=p-name>CSS Paged Media Module Level 3</h1>
    1.14  
    1.15      <h2 class="no-num no-toc" id=w3c-working>Editor's Draft <span
    1.16 -     class=dt-updated><span class=value-title title=20130306> 6 March
    1.17 +     class=dt-updated><span class=value-title title=20130307> 7 March
    1.18       2013</span></span></h2>
    1.19  
    1.20      <dl>
    1.21 @@ -108,7 +108,7 @@
    1.22  
    1.23       <dd><a class=u-url
    1.24        href="http://dev.w3.org/csswg/css3-page/">http://dev.w3.org/csswg/css3-page/</a></dd>
    1.25 -     <!-- <dd><a class="u-url" href="http://dev.w3.org/csswg/css3-page/">http://www.w3.org/TR/2013/WD-css3-page-20130306</a></dd> -->
    1.26 +     <!-- <dd><a class="u-url" href="http://dev.w3.org/csswg/css3-page/">http://www.w3.org/TR/2013/WD-css3-page-20130307</a></dd> -->
    1.27  
    1.28       <dt>Latest version:
    1.29  
    1.30 @@ -219,7 +219,7 @@
    1.31     <p>This document contains the <abbr
    1.32      title="Cascading Style Sheets">CSS3</abbr> Paged Media Module W3C Last
    1.33      Call <a href="/2005/10/Process-20051014/tr.html#RecsWD">Working Draft</a>
    1.34 -    of 6 March 2013. The Last Call period ends on <span
    1.35 +    of 7 March 2013. The Last Call period ends on <span
    1.36      class=fudge>TBD</span>.
    1.37  
    1.38     <p>Expected next revision to this document is another LCWD, due to the
    1.39 @@ -652,24 +652,61 @@
    1.40      element. It remains, however, positioned with respect to the root element
    1.41      or page area as usual.
    1.42  
    1.43 -   <p>The UA may support the <code>z-index</code> property for page-margin
    1.44 -    boxes. With respect to the page-margin boxes, the document canvas, page
    1.45 -    borders, and all of the document contents are treated as a single element
    1.46 -    with a <code>z-index</code> value of ‘<code class=css>0</code>’: the
    1.47 -    page-margin boxes never interleave with parts of the document content or
    1.48 -    between the content and the canvas. They may only paint in front of the
    1.49 -    document content or behind the document canvas. The page background is
    1.50 -    always painted underneath everything else. Since the
    1.51 -    <code>position</code> property does not apply to page-margin boxes,
    1.52 -    <code>z-index</code> always affects page-margin boxes as if they were
    1.53 -    positioned elements regardless of the <code>position</code> property's
    1.54 -    value.
    1.55 +   <p>The ‘<code class=property>z-index</code>’ property applies to
    1.56 +    page-margin boxes. With respect to the page-margin boxes, the document
    1.57 +    canvas, page borders, and all of the document contents are treated as a
    1.58 +    single element with a <code>z-index</code> value of ‘<code
    1.59 +    class=css>0</code>’: the page-margin boxes never interleave with parts
    1.60 +    of the document content or between the content and the canvas. They may
    1.61 +    only paint in front of the document content or behind the document
    1.62 +    canvas. The page background is always painted underneath everything else.
    1.63 +    Since the <code>position</code> property does not apply to page-margin
    1.64 +    boxes, <code>z-index</code> always affects page-margin boxes as if they
    1.65 +    were positioned elements regardless of the <code>position</code>
    1.66 +    property's value.
    1.67  
    1.68     <p>The default painting order, or <a
    1.69      href="http://www.w3.org/TR/CSS21/zindex.html">CSS2.1 Appendix E</a> "tree
    1.70 -    order", of page-margin boxes with respect to each other is not specified.
    1.71 -    However, the page-margin boxes are defined to come after the page box and
    1.72 -    its contents. <span class=issue>Suggestions here are welcome.</span>
    1.73 +    order", of page-margin boxes with respect to each other is as follows:
    1.74 +
    1.75 +   <ol>
    1.76 +    <li>‘<code class=css>@top-left-corner</code>’
    1.77 +
    1.78 +    <li>‘<code class=css>@top-left</code>’
    1.79 +
    1.80 +    <li>‘<code class=css>@top-center</code>’
    1.81 +
    1.82 +    <li>‘<code class=css>@top-right</code>’
    1.83 +
    1.84 +    <li>‘<code class=css>@top-right-corner</code>’
    1.85 +
    1.86 +    <li>‘<code class=css>@right-top</code>’
    1.87 +
    1.88 +    <li>‘<code class=css>@right-middle</code>’
    1.89 +
    1.90 +    <li>‘<code class=css>@right-bottom</code>’
    1.91 +
    1.92 +    <li>‘<code class=css>@bottom-right-corner</code>’
    1.93 +
    1.94 +    <li>‘<code class=css>@bottom-right</code>’
    1.95 +
    1.96 +    <li>‘<code class=css>@bottom-center</code>’
    1.97 +
    1.98 +    <li>‘<code class=css>@bottom-left</code>’
    1.99 +
   1.100 +    <li>‘<code class=css>@bottom-left-corner</code>’
   1.101 +
   1.102 +    <li>‘<code class=css>@left-bottom</code>’
   1.103 +
   1.104 +    <li>‘<code class=css>@left-middle</code>’
   1.105 +
   1.106 +    <li>‘<code class=css>@left-top</code>’
   1.107 +   </ol>
   1.108 +
   1.109 +   <p class=note> Start with ‘<code class=css>@top-left-corner</code>’,
   1.110 +    then go clockwise. This order is arbitrary but can be overridden with
   1.111 +    ‘<code class=property>z-index</code>’. It only has a visible effect
   1.112 +    when page-margin boxes overlap, which should not happen in most cases.
   1.113  
   1.114     <h3 id=content-outside-box><span class=secno>4.2. </span>Content outside
   1.115      the page box</h3>
   1.116 @@ -1480,13 +1517,12 @@
   1.117  
   1.118     <p>As with the ‘<code class=css>:before</code>’ and ‘<code
   1.119      class=css>:after</code>’ pseudo-elements, a specified ‘<code
   1.120 -    class=property>content</code>’ of ‘<code class=css>normal</code>’
   1.121 -    on a page-margin box computes to ‘<code class=css>none</code>’. A
   1.122 -    page-margin box is <dfn id=generated>generated</dfn> if and only if the
   1.123 -    computed value of its ‘<code class=property>content</code>’ property
   1.124 -    is not ‘<code class=property>none</code>’. Otherwise, no box is
   1.125 -    generated, as for elements with ‘<code class=css>display:
   1.126 -    none</code>’.
   1.127 +    class=css>content: normal</code>’ on a page-margin box computes to
   1.128 +    ‘<code class=css>none</code>’. A page-margin box is <dfn
   1.129 +    id=generated>generated</dfn> if and only if the computed value of its
   1.130 +    ‘<code class=property>content</code>’ property is not ‘<code
   1.131 +    class=property>none</code>’. Otherwise, no box is generated, as for
   1.132 +    elements with ‘<code class=css>display: none</code>’.
   1.133  
   1.134     <p class=note> The ‘<code class=property>display</code>’ property does
   1.135      not apply to page-margin boxes.
   1.136 @@ -1943,9 +1979,7 @@
   1.137       href="#page-property-list">properties that apply to page-margin
   1.138       boxes</a>. If a conforming user agent supports any of these properties
   1.139       on block boxes, then it <em class=RFC2119>MUST</em> also support that
   1.140 -     property in the <a href="#margin-context"><i>margin context</i></a>
   1.141 -     (except for <code>z-index</code>, which is optional for page-margin
   1.142 -     boxes.)
   1.143 +     property in the <a href="#margin-context"><i>margin context</i></a>.
   1.144  
   1.145      <p> Other properties defined by <a href="#CSS21"
   1.146       rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> do not apply in these
     2.1 --- a/css3-page/Overview.src.html	Thu Mar 07 16:54:20 2013 +0100
     2.2 +++ b/css3-page/Overview.src.html	Thu Mar 07 17:13:37 2013 +0100
     2.3 @@ -396,10 +396,35 @@
     2.4  
     2.5    <p>The default painting order,
     2.6    or <a href="http://www.w3.org/TR/CSS21/zindex.html">CSS2.1 Appendix E</a> "tree order",
     2.7 -  of page-margin boxes with respect to each other is not specified.
     2.8 -  However, the page-margin boxes are defined to come
     2.9 -  after the page box and its contents.
    2.10 -  <span class="issue">Suggestions here are welcome.</span>
    2.11 +  of page-margin boxes with respect to each other is as follows:
    2.12 +
    2.13 +  <ol>
    2.14 +    <li>''@top-left-corner''
    2.15 +    <li>''@top-left''
    2.16 +    <li>''@top-center''
    2.17 +    <li>''@top-right''
    2.18 +    <li>''@top-right-corner''
    2.19 +
    2.20 +    <li>''@right-top''
    2.21 +    <li>''@right-middle''
    2.22 +    <li>''@right-bottom''
    2.23 +
    2.24 +    <li>''@bottom-right-corner''
    2.25 +    <li>''@bottom-right''
    2.26 +    <li>''@bottom-center''
    2.27 +    <li>''@bottom-left''
    2.28 +    <li>''@bottom-left-corner''
    2.29 +
    2.30 +    <li>''@left-bottom''
    2.31 +    <li>''@left-middle''
    2.32 +    <li>''@left-top''
    2.33 +  </ol>
    2.34 +
    2.35 +  <p class=note>
    2.36 +    Start with ''@top-left-corner'', then go clockwise.
    2.37 +    This order is arbitrary but can be overridden with 'z-index'.
    2.38 +    It only has a visible effect when page-margin boxes overlap,
    2.39 +    which should not happen in most cases.
    2.40  
    2.41  <h3 id="content-outside-box">Content outside the page box</h3>
    2.42