插件窝 干货文章 VuePress中如何实现页面间跳转?

VuePress中如何实现页面间跳转?

使用 Router VuePress 路径 294    来源:    2025-03-25

VuePress 中实现页面间跳转的方法

在 VuePress 中,你可以通过以下几种方式实现页面间的跳转:

1. 使用 Markdown 链接语法

最简单的方式是使用标准的 Markdown 链接语法:

[跳转到首页](/)
[跳转到关于页](/about.md)
[跳转到指定标题](/guide/README.md#标题名称)

2. 使用 Vue Router 的 <router-link> 组件

在 VuePress 中,你可以直接使用 Vue Router 的功能:

<router-link to="/">跳转到首页</router-link>
<router-link to="/about/">关于我们</router-link>

3. 使用编程式导航

在自定义组件或 Vue 文件中,可以使用 this.$router 方法:

methods: {
  goToPage() {
    this.$router.push('/path/to/page')
  }
}

4. 使用 VuePress 的 $page$site 对象

可以动态生成链接:

当前页面路径: {{ $page.path }}

站点基础路径: {{ $site.base }}

5. 链接到外部 URL

[访问Vue官网](https://vuejs.org/)

6. 使用 Frontmatter 定义导航

在页面的 Frontmatter 中定义 prevnext:

---
prev: /guide/README.md
next: /guide/configuration.md
---

注意事项

  1. 链接路径是基于项目根目录的,不需要写 .md 扩展名
  2. 对于中文路径,建议使用 URL 编码或英文路径
  3. 使用相对路径时要注意当前页面的位置
  4. 在自定义主题中,可以通过 this.$sitethis.$page 访问路由信息

示例:动态生成侧边栏链接

// .vuepress/config.js
module.exports = {
  themeConfig: {
    sidebar: [
      {
        title: '指南',
        path: '/guide/',
        children: [
          '/guide/installation',
          '/guide/configuration'
        ]
      }
    ]
  }
}

以上方法可以根据你的具体需求选择使用,VuePress 内置了 Vue Router,因此所有 Vue Router 的功能都可以在 VuePress 中使用。