CSS page Property
The CSS page
property is used with paged media to specify a particular type of page on which an element must be displayed.
The page
property is used in conjunction with the @page
at-rule to determine which type of page should be used with certain elements.
For example, you could specify that all tables are printed in landscape orientation, while other elements are printed in portrait orientation.
The page
property accepts either a <custom-ident> or the auto
keyword as its value.
The <custom-ident> type is a case-sensitive identifier, however the auto
keyword is ASCII case-insensitive (as are all CSS keywords).
Syntax
This means that it can have any one of the following values.
Possible Values
auto
- This is a CSS keyword. Although the
page
property does not inherit, theauto
value will ensure that its used value is the value specified on its nearest ancestor with a non-auto
value. When specified on the root element, the used value forauto
is the empty string. - <custom-ident>
- This is a generic data type that represents a custom identifier defined by the author of the style sheet.
In addition, all CSS properties also accept the following CSS-wide keyword values as the sole component of their property value:
initial
- Represents the value specified as the property's initial value.
inherit
- Represents the computed value of the property on the element's parent.
unset
- This value acts as either
inherit
orinitial
, depending on whether the property is inherited or not. In other words, it sets all properties to their parent value if they are inheritable or to their initial value if not inheritable.
General Information
- Initial Value
auto
- Applies To
- Boxes that create class A break points
- Inherited?
- No
- Media
- Paged
Example Code
Official Specifications
- CSS Paged Media Module Level 3 (W3C Working Draft 14 March 2013)
- CSS Paged Media Module Level 3 (Editor's Draft)
- CSS Level 2.1 (W3C Recommendation 07 June 2011)