:first

Baseline 2023

新推出

自 2023 年 8 月起，此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於舊裝置或瀏覽器。

:first CSS 偽類與 @page at-rule 結合使用時，表示列印文件的第一頁。（有關節點的一般第一個元素，請參閱 :first-child。）

css

/* Selects the first page when printing */
@page :first {
  margin-left: 50%;
  margin-top: 50%;
}

注意：不能使用此偽類更改所有 CSS 屬性。只能更改文件的邊距、orphans、widows 和分頁符。此外，在定義邊距時，只能使用絕對長度單位。所有其他屬性都將被忽略。

語法

css

:first {
  /* ... */
}

按下“列印！”按鈕列印示例。第一頁上的文字應該在頁面中央附近，而其他頁面的內容將保持預設位置。

html

<p>First Page.</p>
<p>Second Page.</p>
<button>Print!</button>

css

@page :first {
  size: 8.5in 11in;
  margin-left: 3in;
  margin-top: 5in;
}

p {
  page-break-after: always;
  font: 1.2em sans-serif;
}

document.querySelector("button").addEventListener("click", () => {
  window.print();
});

規範
CSS 分頁媒體模組第 3 級 # first-pseudo

此頁面最後由 MDN 貢獻者在 2025 年 7 月 14 日修改。