diff --git a/docs/en/reference/default-theme-config.md b/docs/en/reference/default-theme-config.md index 4a43153893cd..f70c5e697083 100644 --- a/docs/en/reference/default-theme-config.md +++ b/docs/en/reference/default-theme-config.md @@ -436,6 +436,13 @@ Can be used to customize the light mode switch title that appears on hovering. Can be used to customize the dark mode switch title that appears on hovering. +## removeExtraElementsInPrint + +- Type: `boolean` +- Default: `false` + +When set to `true`, it will remove extra elements like the sidebar, navbar, and footer when printing the page. If you want to print your docs and don't want to include the extra elements, you can set this option to `true`. + ## sidebarMenuLabel - Type: `string` diff --git a/docs/zh/reference/default-theme-config.md b/docs/zh/reference/default-theme-config.md index a7028f1694b8..657bea9dbc78 100644 --- a/docs/zh/reference/default-theme-config.md +++ b/docs/zh/reference/default-theme-config.md @@ -23,7 +23,8 @@ export default { - 类型:`boolean` -将本地语言更改为 `zh` 会将 URL 从 `/foo`(或 `/en/foo/`)更改为 `/zh/foo`。可以通过将 `themeConfig.i18nRouting` 设置为 `false` 来禁用此行为。 +将本地语言更改为 `zh` 会将 URL 从 `/foo`(或 `/en/foo/`)更改为 `/zh/foo`。可以通过将 `themeConfig.i18nRouting` +设置为 `false` 来禁用此行为。 ## logo @@ -50,7 +51,8 @@ type ThemeableImage = - 类型:`string | false` -可以自定义此项以替换导航中的默认站点标题 (应用配置中的 `title`)。当设置为 `false` 时,导航中的标题将被禁用。这在当 `logo` 已经包含站点标题文本时很有用。 +可以自定义此项以替换导航中的默认站点标题 (应用配置中的 `title`)。当设置为 `false` 时,导航中的标题将被禁用。这在当 `logo` +已经包含站点标题文本时很有用。 ```ts export default { @@ -283,7 +285,8 @@ export interface Footer { - 类型:`EditLink` - 每个页面可以通过 [frontmatter](./frontmatter-config#editlink) 覆盖 -编辑链接可让显示链接以编辑 Git 管理服务 (例如 GitHub 或 GitLab) 上的页面。有关详细信息,请参阅[默认主题:编辑链接](./default-theme-edit-link)。 +编辑链接可让显示链接以编辑 Git 管理服务 (例如 GitHub 或 GitLab) +上的页面。有关详细信息,请参阅[默认主题:编辑链接](./default-theme-edit-link)。 ```ts export default { @@ -342,7 +345,8 @@ export interface LastUpdatedOptions { - 类型:`AlgoliaSearch` -支持使用 [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) 搜索站点文档。在[默认主题:搜索](./default-theme-search) 中了解更多信息。 +支持使用 [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) +搜索站点文档。在[默认主题:搜索](./default-theme-search) 中了解更多信息。 ```ts export interface AlgoliaSearchOptions extends DocSearchProps { @@ -423,6 +427,14 @@ export interface DocFooter { 用于自定义悬停时显示的深色模式开关标题。 +## removeExtraElementsInPrint + +- 类型:`boolean` +- 默认值:`false` + +删除打印页面中的额外元素。当设置为 `true` +时,打印页面时会删除侧边栏、导航栏和页脚等额外元素。如果要打印文档且并不想包含额外元素,可以将此选项设置为 `true`。 + ## sidebarMenuLabel - 类型:`string` diff --git a/src/client/theme-default/components/VPDocFooter.vue b/src/client/theme-default/components/VPDocFooter.vue index 0b6ff2a885d6..5671de77ffbf 100644 --- a/src/client/theme-default/components/VPDocFooter.vue +++ b/src/client/theme-default/components/VPDocFooter.vue @@ -22,10 +22,17 @@ const showFooter = computed( control.value.prev || control.value.next ) + +const classes = computed(() => { + return { + VPDocFooter: true, + 'hidden-print': theme.value.removeExtraElementsInPrint + } +})