tabs.PageSettings

类型 tabs.PageSettings 用于控制 tabs.saveAsPDF() 方法如何将标签页渲染为 PDF。

所有属性都是可选的。

要设置页眉和页脚,您可以在提供的字符串中包含某些特殊字符。这些字符将在渲染的输出中替换为:

  • "&P":页码,例如 "2"
  • "&PT":页码和总页数,例如 "2 of 3"
  • "&D":当前日期/时间
  • "&T":页面标题
  • "&U":页面 URL

类型

此类型的值是对象。它们包含以下属性:

edgeBottom 可选

number。页脚底部与纸张底部的边距(英寸)。默认值:0。

edgeLeft 可选

number。页眉/页脚左侧与纸张左侧的边距(英寸)。默认值:0。

edgeRight 可选

number。页眉/页脚右侧与纸张左侧的边距(英寸)。默认值:0。

edgeTop 可选

number。页眉顶部与纸张顶部的边距(英寸)。默认值:0

footerCenter 可选

string。页面居中文本的页脚内容。默认值:''。

footerLeft 可选

string。页面左侧页脚的文本内容。默认值:'&PT'。

footerRight 可选

string。页面右侧页脚的文本内容。默认值:'&D'。

headerCenter 可选

string。页面居中文本的页眉内容。默认值:''。

headerLeft 可选

string。页面左侧页眉的文本内容。默认值:'&T'。

headerRight 可选

string。页面右侧页眉的文本内容。默认值:'&U'。

marginBottom 可选

number。页面内容与纸张底部的边距(英寸)。默认值:0.5。

marginLeft 可选

number。页面内容与纸张左侧的边距(英寸)。默认值:0.5。

marginRight 可选

number。页面内容与纸张右侧的边距(英寸)。默认值:0.5。

marginTop 可选

number。页面内容与纸张顶部的边距(英寸)。默认值:0.5。

orientation 可选

integer。页面方向:0 表示“纵向”,1 表示“横向”。默认值:0。

paperHeight 可选

number。纸张高度(以纸张尺寸单位计)。默认值:11.0。

paperSizeUnit 可选

integer。纸张尺寸单位:0 = 英寸,1 = 毫米。默认值:0。

paperWidth 可选

number。纸张宽度(以纸张尺寸单位计)。默认值:8.5。

scaling 可选

number。页面内容缩放因子。1 表示 100% 或正常大小。默认值:1。

showBackgroundColors 可选

boolean。是否显示页面背景颜色。默认值:false。

showBackgroundImages 可选

boolean。是否显示页面背景图像。默认值:false。

shrinkToFit 可选

boolean。页面内容是否应缩小以适应页面宽度(覆盖缩放)。默认值:true。

toFileName 可选

string。保存 PDF 的文件名,可以包含或不包含 .pdf 扩展名。

浏览器兼容性