内置组件
ClientOnly
- 使用:
<ClientOnly>
<NonSsrFriendlyComponent />
</ClientOnly>
详情:
该组件和它的子元素只会在客户端被渲染。也就是说,它不会在构建 (SSR) 过程中被渲染到 HTML 内。
如果一个组件在
setup()
中直接使用 浏览器 / DOM API ,它会导致构建过程报错,因为这些 API 在 Node.js 的环境中是无法使用的。在这种情况下,你可以选择一种方式:- 修改这个组件,只在
onBeforeMount()
或onMounted()
Hook 中使用 浏览器 / DOM API 。 - 使用
<ClientOnly>
包裹这个组件。
- 修改这个组件,只在
Content
Props:
- path
- 类型:
string
- 是否必须:
false
- 类型:
- path
使用:
<Content path="/path/to/page.md" />
详情:
该组件会渲染页面的 Markdown 内容。
如果没有传入
path
Prop ,它会渲染当前路由下的页面内容。该组件主要是为了开发主题时使用。在绝大多数情况下你不会用到它。
参考:
RouteLink
Props:
- to
- 类型:
string
- 是否必须:
true
- 类型:
- active
- 类型:
boolean
- 是否必须:
false
- 默认值:
false
- 类型:
- activeClass
- 类型:
string
- 是否必须:
false
- 默认值:
'route-link-active'
- 类型:
- to
使用:
<RouteLink to="/path/to/target-page.md">目标页面</RouteLink>
<RouteLink active to="/path/to/current-page.md">当前页面</RouteLink>
详情:
该组件会渲染一个链接,用于跳转到指定页面。
如果
active
Prop 被设置为true
,那么这个链接会被额外添加一个activeClass
类名。需要注意的是,这里的 active 状态并不会根据当前路由自动更新。该组件主要是为了开发主题时使用。在绝大多数情况下你不会用到它。对于主题作者来说,我们建议你尽可能使用这个组件,而不是使用
vue-router
的<RouterLink>
组件。