Skip to content

Commit d16f3a1

Browse files
committed
Removing section 3.3 Using named pages: the 'page' prroperty, since this topic is not breaking specifiec and can be defined by the css3-page module.
1 parent f92d621 commit d16f3a1

2 files changed

Lines changed: 4 additions & 236 deletions

File tree

css3-break/Overview.html

Lines changed: 4 additions & 145 deletions
Original file line numberDiff line numberDiff line change
@@ -163,10 +163,6 @@ <h2 class="no-num no-toc" id=contents> Table of contents</h2>
163163
href="#breaks-inside"><span class=secno>3.2. </span> Breaks inside
164164
elements: &lsquo;<code class=property>orphans</code>&rsquo;,
165165
&lsquo;<code class=property>widows</code>&rsquo;</a>
166-
167-
<li id=using-named-pages-the-page-property-><a
168-
href="#using-named-pages"><span class=secno>3.3. </span> Using named
169-
pages: the &lsquo;<code class=property>page</code>&rsquo; property</a>
170166
</ul>
171167

172168
<li id=rules-for-breaking-4.1.-allowed-page-bre><a
@@ -553,8 +549,8 @@ <h3 id=explicit-break-properties><span class=secno>3.1. </span> Breaking
553549
than &lsquo;<code class=css>auto</code>&rsquo;, the forced break values
554550
(&lsquo;<code class=css>always</code>&rsquo;, &lsquo;<code
555551
class=css>left</code>&rsquo;, &lsquo;<code class=css>right</code>&rsquo;,
556-
&lsquo;<a href="#page"><code class=css>page</code></a>&rsquo;,
557-
&lsquo;<code class=css>column</code>&rsquo; and &lsquo;<code
552+
&lsquo;<code class=css>page</code>&rsquo;, &lsquo;<code
553+
class=css>column</code>&rsquo; and &lsquo;<code
558554
class=css>region</code>&rsquo;) take precedence over the values
559555
(&lsquo;<code class=css>avoid-page</code>&rsquo;, &lsquo;<code
560556
class=css>avoid-column</code>&rsquo; and &lsquo;<code
@@ -687,126 +683,6 @@ <h3 id=breaks-inside><span class=secno>3.2. </span> Breaks inside elements:
687683
class=property>orphans</code></a>&rsquo;, the rule simply becomes that all
688684
lines in the block must be kept together.
689685

690-
<h3 id=using-named-pages><span class=secno>3.3. </span> Using named pages:
691-
the &lsquo;<a href="#page"><code class=property>page</code></a>&rsquo;
692-
property</h3>
693-
694-
<table class=propdef summary="property definition">
695-
<tbody>
696-
<tr>
697-
<th>Name:
698-
699-
<td><dfn id=page>page</dfn>
700-
701-
<tr>
702-
<th>Value:
703-
704-
<td>auto | &lt;identifier&gt;
705-
706-
<tr>
707-
<th>Initial:
708-
709-
<td>auto
710-
711-
<tr>
712-
<th>Applies to:
713-
714-
<td>block-level elements
715-
716-
<tr>
717-
<th>Inherited:
718-
719-
<td>no (but see prose)
720-
721-
<tr>
722-
<th>Percentages:
723-
724-
<td>N/A
725-
726-
<tr>
727-
<th>Media:
728-
729-
<td>paged
730-
731-
<tr>
732-
<th>Computed value:
733-
734-
<td>specified value
735-
</table>
736-
737-
<p id=the-page-property-is-used-to-specify-a-p> The &lsquo;<a
738-
href="#page"><code class=property>page</code></a>&rsquo; property is used
739-
to specify a particular type of page where an element should be displayed.
740-
741-
742-
<div class=example>
743-
<p id=this-example-will-put-all-tables-on-a-ri>This example will put all
744-
tables on a right-hand side landscape page (named "rotated"):</p>
745-
746-
<pre>
747-
<!-- -->@page rotated { size: landscape }
748-
<!-- -->table { page: rotated; page-break-before: right }</pre>
749-
</div>
750-
751-
<p id=the-page-property-works-as-follows-if-a-> The &lsquo;<a
752-
href="#page"><code class=property>page</code></a>&rsquo; property works as
753-
follows: If a block box with inline content has a &lsquo;<a
754-
href="#page"><code class=property>page</code></a>&rsquo; property that is
755-
different from the preceding block box with inline content, then one or
756-
two page breaks are inserted between them, and the boxes after the break
757-
are rendered on a page box of the named type. See <a
758-
href="#forced-pg-brk">"Forced page breaks" below</a>.
759-
760-
<p id=the-page-property-does-not-inherit.-howe> The &lsquo;<a
761-
href="#page"><code class=property>page</code></a>&rsquo; property does not
762-
inherit. However, if the &lsquo;<a href="#page"><code
763-
class=property>page</code></a>&rsquo; value on an element is &lsquo;<code
764-
class=css>auto</code>&rsquo;, then it is treated as having the same name
765-
as its nearest ancestor with a non-auto value. When indicated on the root
766-
element, the effective name is the empty string.
767-
768-
<p id=because-a-previous-version-of-this-speci> Because a previous version
769-
of this specification indicated that the &lsquo;<a href="#page"><code
770-
class=property>page</code></a>&rsquo; property is inherited, an
771-
implementation that inherits the &lsquo;<a href="#page"><code
772-
class=property>page</code></a>&rsquo; property and treats &lsquo;<code
773-
class=css>auto</code>&rsquo; as always naming the empty string remains
774-
conformant to CSS3 Paged Media. Therefore authors should not explicitly
775-
specify the &lsquo;<code class=css>auto</code>&rsquo; value on a
776-
descendant of an element with a non-&lsquo;<code
777-
class=css>auto</code>&rsquo; &lsquo;<a href="#page"><code
778-
class=property>page</code></a>&rsquo; value as the resulting behavior will
779-
be unpredictable.
780-
781-
<p id=page-names-are-case-sensitive-identifier> Page names are
782-
case-sensitive identifiers. However the &lsquo;<code
783-
class=css>auto</code>&rsquo; value, being a CSS keyword, is <a
784-
href="http://www.w3.org/TR/CSS21/syndata.html#characters">case-insensitive</a>.
785-
786-
787-
<div class=example>
788-
<p id=in-this-example-the-two-tables-are-rende> In this example, the two
789-
tables are rendered on landscape pages (indeed, on the same page, if they
790-
fit). The page type "narrow" is used for the &lt;p&gt; after the second
791-
table, as the page properties for the table element are no longer in
792-
effect:</p>
793-
794-
<pre>
795-
<!-- -->@page narrow { size: 9cm 18cm }
796-
<!-- -->@page rotated { size: landscape }
797-
<!-- -->div { page: narrow }
798-
<!-- -->table { page: rotated }</pre>
799-
800-
<p id=with-this-document-> with this document:</p>
801-
802-
<pre>
803-
<!-- -->&lt;div&gt;
804-
<!-- -->&lt;table&gt;...&lt;/table&gt;
805-
<!-- -->&lt;table&gt;...&lt;/table&gt;
806-
<!-- -->&lt;p&gt;This text is rendered on a 'narrow' page&lt;/p&gt;
807-
<!-- -->&lt;/div&gt;</pre>
808-
</div>
809-
810686
<h2 id=breaking-rules><span class=secno>4. </span> Rules for Breaking</h2>
811687

812688
<p id=when-a-break-splits-a-box-the-boxs-botto> When a break splits a box,
@@ -904,8 +780,8 @@ <h3 id=forced-pg-brk><span class=secno>4.2. </span> Forced page breaks</h3>
904780

905781
<p id=a-page-break-must-also-occur-at-1-if-the> A page break must also
906782
occur at <a href="#brk-btw-blocks">(1)</a> if the last line box above this
907-
margin and the first one below it do not have the same value for &lsquo;<a
908-
href="#page"><code class=property>page</code></a>&rsquo;.
783+
margin and the first one below it do not have the same value for
784+
&lsquo;<code class=property>page</code>&rsquo;.
909785

910786
<p id=when-a-forced-page-break-occurs-at-1-the> When a forced page break
911787
occurs at <a href="#brk-btw-blocks">(1)</a>, the used values of any
@@ -1297,8 +1173,6 @@ <h2 class=no-num id=index>Index</h2>
12971173

12981174
<li>orphans, <a href="#orphans" title=orphans><strong>3.2.</strong></a>
12991175

1300-
<li>page, <a href="#page" title=page><strong>3.3.</strong></a>
1301-
13021176
<li>pagination, <a href="#pagination"
13031177
title=pagination><strong>1.</strong></a>
13041178

@@ -1399,21 +1273,6 @@ <h2 class=no-num id=property-index>Property index</h2>
13991273

14001274
<td>visual
14011275

1402-
<tr>
1403-
<th><a class=property href="#page">page</a>
1404-
1405-
<td>auto | &lt;identifier&gt;
1406-
1407-
<td>auto
1408-
1409-
<td>block-level elements
1410-
1411-
<td>no (but see prose)
1412-
1413-
<td>N/A
1414-
1415-
<td>paged
1416-
14171276
<tr>
14181277
<th><a class=property href="#widows">widows</a>
14191278

css3-break/Overview.src.html

Lines changed: 0 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -443,97 +443,6 @@ <h3 id="breaks-inside">
443443
simply becomes that all lines in the block must be kept together.
444444
</p>
445445

446-
<h3 id="using-named-pages">
447-
Using named pages: the 'page' property</h3>
448-
449-
<table class="propdef" summary="property definition">
450-
<tr>
451-
<th>Name:
452-
<td><dfn id="page">page</dfn>
453-
<tr>
454-
<th>Value:
455-
<td>auto | &lt;identifier&gt;
456-
<tr>
457-
<th>Initial:
458-
<td>auto
459-
<tr>
460-
<th>Applies to:
461-
<td>block-level elements
462-
<tr>
463-
<th>Inherited:
464-
<td>no (but see prose)
465-
<tr>
466-
<th>Percentages:
467-
<td>N/A
468-
<tr>
469-
<th>Media:
470-
<td>paged
471-
<tr>
472-
<th>Computed value:
473-
<td>specified value
474-
</table>
475-
476-
<p>
477-
The 'page' property is used to specify a particular
478-
type of page where an element should be displayed.
479-
</p>
480-
481-
<div class="example">
482-
<p>This example will put all tables on a right-hand side landscape page (named "rotated"):</p>
483-
<pre>
484-
<!-- -->@page rotated { size: landscape }
485-
<!-- -->table { page: rotated; page-break-before: right }</pre>
486-
</div>
487-
488-
<p>
489-
The 'page' property works as follows: If a block box
490-
with inline content has a 'page' property that is
491-
different from the preceding block box with inline content, then one or two page
492-
breaks are inserted between them, and the boxes after the break are rendered on
493-
a page box of the named type. See <a href="#forced-pg-brk">"Forced page breaks" below</a>.
494-
</p>
495-
<p>
496-
The 'page' property does not inherit. However, if the 'page' value on an element
497-
is ''auto'', then it is treated as having the same name as its nearest ancestor
498-
with a non-auto value. When indicated on the root element, the effective name is
499-
the empty string.
500-
</p>
501-
<p>
502-
Because a previous version of this specification indicated that the 'page' property
503-
is inherited, an implementation that inherits the 'page' property and treats ''auto''
504-
as always naming the empty string remains conformant to CSS3 Paged Media. Therefore
505-
authors should not explicitly specify the ''auto'' value on a descendant of an element
506-
with a non-''auto'' 'page' value as the resulting behavior will be unpredictable.
507-
</p>
508-
509-
<p>
510-
Page names are case-sensitive identifiers. However the ''auto'' value, being a CSS
511-
keyword, is <a href="http://www.w3.org/TR/CSS21/syndata.html#characters">case-insensitive</a>.
512-
</p>
513-
514-
<div class="example">
515-
516-
<p>
517-
In this example, the two tables are rendered on landscape pages (indeed, on the
518-
same page, if they fit). The page type "narrow" is used for the &lt;p&gt; after
519-
the second table, as the page properties for the table element are no longer in
520-
effect:</p>
521-
<pre>
522-
<!-- -->@page narrow { size: 9cm 18cm }
523-
<!-- -->@page rotated { size: landscape }
524-
<!-- -->div { page: narrow }
525-
<!-- -->table { page: rotated }</pre>
526-
<p>
527-
with this document:
528-
</p>
529-
<pre>
530-
<!-- -->&lt;div&gt;
531-
<!-- -->&lt;table&gt;...&lt;/table&gt;
532-
<!-- -->&lt;table&gt;...&lt;/table&gt;
533-
<!-- -->&lt;p&gt;This text is rendered on a 'narrow' page&lt;/p&gt;
534-
<!-- -->&lt;/div&gt;</pre>
535-
</div>
536-
537446
<h2 id="breaking-rules">
538447
Rules for Breaking</h2>
539448

0 commit comments

Comments
 (0)