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

浏览器兼容性