主题外观选项

  • 配置
  • 主题配置
  • 外观
大约 2 分钟

以下选项控制主题的外观,一般情况下你无需关注他们,它们仅为有相关配置需求的少数用户提供。

注意

这些选项仅支持在主题配置中直接配置,而不支持在各语言中分别配置。

iconAssets 仅限 Root

  • 类型: "iconfont" | "fontawesome" | `//${string}` | `http://${string}` | `https://${string}`
  • 必填: 否
  • 详情: 界面 → 图标

字体图标资源链接,支持 'iconfont''fontawesome' 关键字。

darkmode 默认启用 仅限 Root

深色模式支持选项:

  • "switch": 在深色模式,浅色模式和自动之间切换
  • "toggle": 在深色模式和浅色模式之间切换
  • "auto": 自动根据用户设备主题或当前时间决定是否应用深色模式
  • "enable": 强制深色模式
  • "disable": 禁用深色模式

如果你不需要这项功能,请设置 darkmode: "disable" 将其禁用。

themeColor 仅限 Root

主题色选项配置。

fullscreen

是否显示全屏按钮。

backToTop 仅限 Root

  • 类型: boolean | number
  • 默认值: true

是否显示返回顶部按钮。

如果设置为数字,则该数字为触发临界值 (默认临界值为 300px)。

mobileBreakPoint 仅限 Root

  • 类型: number
  • 默认值: 719

切换桌面布局和移动布局的窗口宽度,单位像素。

注意

你需要将此选项和 .vuepress/config.scss 中的 $tablet 保持一致。

pure 仅限 Root

是否开启纯净模式。

提示

启用此功能将禁用一些花哨的样式。

当你想提供“纯文档站点”时很有用。

iconPrefix 仅限 Root

通常情况下,它可以识别 iconAssets 并自动设置,如果识别失败,你可以手动设置图标的 FontClass 前缀。

Loading...