size

Baseline 2024
新推出

自 2024 年 12 月起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能無法在舊版裝置或瀏覽器上使用。

size CSS @規則描述符,與 @page @規則一起使用,定義了用於表示頁面的盒子的大小和方向。在大多數情況下,這個大小對應於目標列印頁面的大小(如果適用)。

大小可以用“可伸縮”關鍵字(在這種情況下,頁面將填充可用尺寸)或絕對尺寸來定義。

語法

css
/* Keyword values for scalable size */
size: auto;
size: portrait;
size: landscape;

/* <length> values */
/* 1 value: height = width */
size: 6in;

/* 2 values: width then height */
size: 4in 6in;

/* Keyword values for absolute size */
size: A4;
size: B5;
size: JIS-B4;
size: letter;

/* Mixing size and orientation */
size: A4 portrait;

auto

使用者代理決定頁面大小。在大多數情況下,使用目標紙張的尺寸和方向。

landscape(橫向)

頁面內容以橫向模式顯示(即,盒子的最長邊是水平的)。

portrait(縱向)

頁面內容以縱向模式顯示(即,盒子的最長邊是垂直的)。這是預設方向。

<length>

任何長度值(參見 <length>)。第一個值對應於頁面盒子的寬度,第二個值對應於其高度。如果只提供一個值,它將同時用於寬度和高度。

<page-size>(頁面大小)

一個關鍵字,可以是以下任何值:

A5

這與標準的 ISO 尺寸匹配:148mm x 210mm。

A4

這與標準的 ISO 尺寸匹配:210mm x 297mm。(個人列印最常用尺寸。)

A3

這與標準的 ISO 尺寸匹配:297mm x 420mm。

B5

這與標準的 ISO 尺寸匹配:176mm x 250mm。

B4

這與標準的 ISO 尺寸匹配:250mm x 353mm。

JIS-B5

這對應於 JIS 標準尺寸:182mm x 257mm。

JIS-B4

這對應於 JIS 標準尺寸:257mm x 364mm。

letter(信紙)

此關鍵字等同於北美信紙的尺寸,即 8.5 英寸 x 11 英寸。

此關鍵字等同於北美法律用紙的尺寸,即 8.5 英寸 x 14 英寸。

ledger(分類賬)

此關鍵字等同於北美分類賬頁面的尺寸,即 11 英寸 x 17 英寸。

正式定義

相關的 at-rule@page
初始值auto
計算值按指定值,但相對長度會轉換為絕對長度。

正式語法

size = 
<length [0,∞]>{1,2} |
auto |
[ <page-size> || [ portrait | landscape ] ]

示例

指定大小和方向

css
@page {
  size: A4 landscape;
}

指定自定義大小

css
@page {
  size: 4in 6in;
}

巢狀在 @media 規則中

css
@media print {
  @page {
    size: 50mm 150mm;
  }
}

規範

規範
CSS 分頁媒體模組第 3 級
# page-size-prop

瀏覽器相容性