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
。 -
string
。页面中心页脚的文本内容。默认值为''
。 -
string
。页面左侧页脚的文本内容。默认值为'\&PT'
。 -
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
扩展名或不包含。
浏览器兼容性
BCD tables only load in the browser