@page

CSS の @page ＠規則は、文書を印刷するときに一部の CSS プロパティを変更するために使用します。 @page で変更できる CSS プロパティは限られます。変更できるのは、 margin, orphans, widows と、文書のページ区切りだけです。これ以外の CSS プロパティを変えようとしても、無視されます。

@page {
  margin: 1cm;
}

@page :first {
  margin: 2cm;
}

@page ＠規則は、 CSS オブジェクトモデルインターフェイス CSSPageRule からアクセスできます。

構文

ディスクリプター

size

対象となるページボックスの包含ブロックの寸法と向きを指定します。一般的な場合、1つのページボックスが1枚の用紙に印刷され、対象となる用紙の寸法を示します。

marks

クロップや登録マークを文書に追加します。

bleed

ページのレンダリングがクリップされた場合の、ページボックス間の距離を示します。

形式文法

@page <page-selector-list> {
  <page-body>
}
where 
<page-selector-list> = [ <page-selector># ]?
<page-body> = <declaration>? [ ; <page-body> ]? | <page-margin-box> <page-body>
where 
<page-selector> = <pseudo-page>+ | <ident> <pseudo-page>*
<page-margin-box> = <page-margin-box-type> {
  <declaration-list>
}
where 
<pseudo-page> = : [ left | right | first | blank ]
<page-margin-box-type> = @top-left-corner | @top-left | @top-center | @top-right | @top-right-corner | @bottom-left-corner | @bottom-left | @bottom-center | @bottom-right | @bottom-right-corner | @left-top | @left-middle | @left-bottom | @right-top | @right-middle | @right-bottom

例

@page の さまざまな擬似クラスのページにある、利用例を参照してください。

• :blank
• :first
• :left
• :right
• :recto
• :verso

仕様書

ブラウザーの対応

このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。

関連情報

• この件 (ページベースのカウンターなど) に関する進捗の追跡は、 Bugzilla のチケット [META] CSS Paged Media Module Level 3 をご覧ください。