内容表

• Type
• 浏览器兼容性

tabs.PageSettings

The type tabs.PageSettings is used to control how a tab is rendered as a PDF by the tabs.saveAsPDF() 方法。

All its properties are optional.

For setting headers and footers, you can include certain special characters in the strings you supply. These will be replaced in the rendered output as follows:

• "&P": the page number, like "2"
• "&PT": the page number and the total number of pages, like "2 of 3"
• "&D": the current date/time
• "&T": the page title
• "&U": the page URL

类型

Values of this type are objects. They contain the following properties:

edgeBottom 可选

编号 . The spacing between the bottom of the footers and the bottom edge of the paper (inches). Default: 0.

edgeLeft 可选

编号 . The spacing between the left header/footer and the left edge of the paper (inches). Default: 0.

edgeRight 可选

编号 . The spacing between the right header/footer and the left edge of the paper (inches). Default: 0.

edgeTop 可选

编号 . The spacing between the top of the headers and the top edge of the paper (inches). Default: 0

footerCenter 可选

string . The text for the page's center footer. Default: ''.

footerLeft 可选

string . The text for the page's left footer. Default: '&PT'.

footerRight 可选

string . The text for the page's right footer. Default: '&D'.

headerCenter 可选

string . The text for the page's center header. Default: ''.

headerLeft 可选

string . The text for the page's left header. Default: '&T'.

headerRight 可选

string . The text for the page's right header. Default: '&U'.

marginBottom 可选

编号 . The margin between the page content and the bottom edge of the paper (inches). Default: 0.5.

marginLeft 可选

编号 . The margin between the page content and the left edge of the paper (inches). Default: 0.5.

marginRight 可选

编号 . The margin between the page content and the right edge of the paper (inches). Default: 0.5.

marginTop 可选

编号 . The margin between the page content and the top edge of the paper (inches). Default: 0.5.

orientation 可选

integer . Page orientation: 0 means "portrait", 1 means "landscape". Default: 0.

paperHeight 可选

编号 . The paper height in paper size units. Default: 11.0.

paperSizeUnit 可选

integer . The paper size unit: 0 = inches, 1 = millimeters. Default: 0.

paperWidth 可选

编号 . The paper width in paper size units. Default: 8.5.

scaling 可选

编号 . Page content scaling factor. 1 means 100% or normal size. Default: 1.

showBackgroundColors 可选

boolean . Whether the page background colors should be shown. Default: false.

showBackgroundImages 可选

boolean . Whether the page background images should be shown. Default: false.

shrinkToFit 可选

boolean . Whether the page content should shrink to fit the page width (overrides scaling). Default: true.

toFileName 可选

string . The name of the file the PDF is saved in, with or without the .pdf extension.

浏览器兼容性

BCD tables only load in the browser

Found a problem with this page?

• Edit on GitHub
• Source on GitHub
• Report a problem with this content on GitHub
• Want to fix the problem yourself? See our Contribution guide .

最后修改： Oct 26, 2021 , 由 MDN 贡献者

相关话题

1. 浏览器扩展名
2. 快速入门

   1. What are extensions?
   2. Your first extension
   3. Your second extension
   4. Anatomy of an extension
   5. Example extensions
   6. What next?
3. 概念

   1. Using the JavaScript APIs
   2. Content scripts
   3. Match patterns
   4. Working with files
   5. 国际化
   6. Content Security Policy
   7. Native messaging
   8. Differences between API implementations
   9. Chrome incompatibilities
4. 用户界面

   1. 用户界面
   2. Toolbar button
   3. Address bar button
   4. Sidebars
   5. Context menu items
   6. Options page
   7. Extension pages
   8. Notifications
   9. Address bar suggestions
   10. Developer tools panels
5. 如何

   1. Intercept HTTP requests
   2. Modify a web page
   3. Insert external content
   4. Share objects with page scripts
   5. Add a button to the toolbar
   6. Implement a settings page
   7. Work with the Tabs API
   8. Work with the Bookmarks API
   9. Work with the Cookies API
   10. Work with contextual identities
   11. Interact with the clipboard
   12. Build a cross-browser extension
6. Firefox differentiators
7. JavaScript API

   1. Browser support for JavaScript APIs
   2. alarms
   3. bookmarks
   4. browserAction
   5. browserSettings
   6. browsingData
   7. captivePortal
   8. clipboard
   9. 命令
   10. contentScripts
   11. contextualIdentities
   12. Cookie
   13. devtools
   14. dns
   15. downloads
   16. events
   17. extension
   18. extensionTypes
   19. find
   20. history
   21. i18n
   22. identity
   23. idle
   24. management
   25. menus
   26. notifications
   27. omnibox
   28. pageAction
   29. permissions
   30. pkcs11
   31. privacy
   32. proxy
   33. runtime
   34. search
   35. sessions
   36. sidebarAction
   37. storage
   38. tabs
       1. 方法
          1. captureTab()
          2. captureVisibleTab()
          3. connect()
          4. create()
          5. detectLanguage()
          6. discard()
          7. duplicate()
          8. executeScript()
          9. get()
          10. getAllInWindow()
          11. getCurrent()
          12. getSelected()
          13. getZoom()
          14. getZoomSettings()
          15. goBack()
          16. goForward()
          17. hide()
          18. highlight()
          19. insertCSS()
          20. move()
          21. moveInSuccession()
          22. print()
          23. printPreview()
          24. query()
          25. reload()
          26. remove()
          27. removeCSS()
          28. saveAsPDF()
          29. sendMessage()
          30. sendRequest()
          31. setZoom()
          32. setZoomSettings()
          33. show()
          34. toggleReaderMode()
          35. update()
          36. warmup()
       2. 特性
          1. TAB_ID_NONE
       3. 类型
          1. MutedInfo
          2. MutedInfoReason
          3. PageSettings
          4. Tab
          5. TabStatus
          6. WindowType
          7. ZoomSettings
          8. ZoomSettingsMode
          9. ZoomSettingsScope
       4. 事件
          1. onActivated
          2. onActiveChanged
          3. onAttached
          4. onCreated
          5. onDetached
          6. onHighlightChanged
          7. onHighlighted
          8. onMoved
          9. onRemoved
          10. onReplaced
          11. onSelectionChanged
          12. onUpdated
          13. onZoomChange
   39. theme
   40. topSites
   41. 类型
   42. userScripts
   43. webNavigation
   44. webRequest
   45. windows
8. Manifest keys

   1. 介绍

   1. 作者
   2. background
   3. browser_action
   4. browser_specific_settings
   5. chrome_settings_overrides
   6. chrome_url_overrides
   7. 命令
   8. content_scripts
   9. content_security_policy
   10. default_locale
   11. description
   12. developer
   13. devtools_page
   14. dictionaries
   15. externally_connectable
   16. homepage_url
   17. icons
   18. incognito
   19. manifest_version
   20. name
   21. offline_enabled
   22. omnibox
   23. optional_permissions
   24. options_page
   25. options_ui
   26. page_action
   27. permissions
   28. protocol_handlers
   29. short_name
   30. sidebar_action
   31. storage
   32. theme
   33. theme_experiment
   34. user_scripts
   35. version
   36. version_name
   37. web_accessible_resources
9. Extension Workshop

   1. Develop
   2. Publish
   3. Manage
   4. Enterprise
10. Contact us
11. Channels

    1. Add-ons blog
    2. Add-ons forum
    3. Add-ons chat