Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

@page

Baseline 2024
Disponible recientemente
*

Desde diciembre de 2024, esta característica funciona en los dispositivos y las versiones de navegador más recientes. Es posible que no funcione en dispositivos o navegadores más antiguos.

* Algunas partes de esta característica pueden tener distintos niveles de compatibilidad.

Resumen

La regla @page es usada para modificar algunas propiedades CSS cuando se va a imprimir una página web. No se pueden cambiar todas las propiedades CSS con @page, solo los márgenes, las líneas viudas, huérfanas y los saltos de página. Cualquier intento de cambiar otra propiedad será ignorada.

La regla @page puede ser accesada por medio de la interfaz modelo objeto CSSPageRule.

Nota: La W3C esta discutiendo como manejar las unidades relativas <length> : vh, vw, vmin, y vmax. Mientras tanto, se recomienda no usarlas en la regla @page.

Sintaxis

Descriptores

size

Especifica el tamaño y la orientación de la caja objetivo de la página. En general, una caja es representada dentro de una hoja, también indica el tamaño de la hoja destino.

marks

Añade marcas de corte y/o registro al documento.

bleed

Especifica la extensión más allá de la caja de página a la que se recorta el procesamiento de página.

Sintaxis Formal

@page = 
@page <page-selector-list>? { <declaration-rule-list> }

<page-selector-list> =
<page-selector>#

<page-selector> =
[ <ident-token>? <pseudo-page>* ]!

<pseudo-page> =
: [ left | right | first | blank ]

Ejemplos

Por favor dirígete a las pseudo-classes de @page por ejemplos.

Especificaciones

Especificación
CSS Paged Media Module Level 3
# at-page-rule
CSS Logical Properties and Values Module Level 1
# page

Compatibilidad con navegadores