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, the auto 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 for auto 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 or initial, 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

Example Code

Official Specifications

• CSS Paged Media Module Level 3 (W3C Editor's Draft)
• CSS Paged Media Module Level 3 (W3C Working Draft)
• CSS Level 2.1 (W3C Recommendation 07 June 2011)

Browser Support

Browser support for CSS properties can vary, particularly for newer or experimental features. Check current browser compatibility before using a property in production, especially when supporting older browsers.

Initial Value

CSS properties have an initial value that applies when the property has not been explicitly set. The initial value is different from the value inherited from a parent element and may vary between properties.

Inheritance

Some CSS properties inherit their computed value from their parent element by default, while others do not. The inherit, initial, unset, and revert keywords can also be used to control how a property gets its value.

Vendor Prefixes

Most modern CSS properties use the standard, unprefixed syntax. Vendor-prefixed properties such as -webkit- are mainly relevant to older browser versions or specific features and should only be used when required by your browser support targets.