Vue / 系统课时

路由实例与页面映射

路由实例与页面映射

本节完成一个最小但完整的 Vue Router 配置:创建 history、声明页面路由、组织嵌套路由,并用默认跳转把父级入口导向具体子页面。完成后,你可以从 URL 稳定映射到页面组件,并为后续权限、懒加载和页面布局打好结构基础。

学习目标

  • 能使用 createRouter 与 createWebHistory 创建路由实例。
  • 能用路由记录把路径映射到页面组件,并组织父子嵌套路由。
  • 能正确配置默认跳转,并理解父级 <RouterView> 在嵌套路由中的作用。

建立路由实例

Vue Router 的核心由两部分组成:history 决定 URL 如何与浏览器历史协作,routes 决定具体路径匹配哪个页面组件。企业项目通常把路由配置独立放在 src/router/index.ts,再在应用入口注册。以下为片段示例,假设项目已经安装 vue-router 且示例页面组件存在。

ts
import { createRouter, createWebHistory } from 'vue-router'
import HomePage from '@/views/HomePage.vue'
import SettingsLayout from '@/views/settings/SettingsLayout.vue'
import ProfilePage from '@/views/settings/ProfilePage.vue'
import SecurityPage from '@/views/settings/SecurityPage.vue'

const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    {
      path: '/',
      name: 'home',
      component: HomePage
    },
    {
      path: '/settings',
      component: SettingsLayout,
      children: [
        {
          path: '',
          redirect: { name: 'settings-profile' }
        },
        {
          path: 'profile',
          name: 'settings-profile',
          component: ProfilePage
        },
        {
          path: 'security',
          name: 'settings-security',
          component: SecurityPage
        }
      ]
    }
  ]
})

export default router

createWebHistory() 使用常见的 History API 地址形式,例如 /settings/profile。import.meta.env.BASE_URL 能让路由基地址与 Vite 的部署基路径保持一致,避免应用部署到子目录时手写前缀。

理解页面映射与嵌套关系

一个路由记录至少要解决“匹配条件”和“渲染目标”。path 负责匹配 URL,component 指向要渲染的页面。name 不是强制字段,但企业项目通常保留稳定的名称,方便跳转时避免手写路径。

Vue Router 路由记录与嵌套页面映射

父路由使用 children 后,子路由的 path 通常写相对路径,不以 / 开头。这样 profile 会自动组合成 /settings/profile,并且会渲染到父组件中的 <RouterView>。

SettingsLayout.vue 至少需要保留子路由出口。以下为片段示例:

vue
<template>
  <main>
    <h1>设置中心</h1>
    <RouterView />
  </main>
</template>

如果父路由声明了 children,但父组件没有 <RouterView>,URL 虽然可能成功匹配,子页面却没有可渲染的位置。

注册并验证路由

在应用入口把路由实例注册到 Vue 应用。以下为片段示例:

ts
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'

createApp(App)
  .use(router)
  .mount('#app')

根组件也要提供顶层路由出口。以下为片段示例:

vue
<template>
  <RouterView />
</template>

启动项目后访问对应地址:

bash
npm run dev

预期输出

text
VITE v<VALUE> ready in <TIME> ms
Local: http://localhost:<PORT>/

实际 Vite 版本、启动耗时与端口可能不同。打开 / 应显示首页;访问 /settings/profile 应在设置布局中显示个人资料页;访问 /settings/security 应在同一布局中显示安全设置页。

用默认跳转稳定入口

/settings 本身只代表一个页面分组时,通常不希望它显示空白内容。上面的空子路径记录会在访问 /settings 时重定向到命名路由 settings-profile,最终地址变为 /settings/profile。

使用命名路由作为重定向目标有一个好处:以后如果实际路径从 profile 改成 account,只要保留名称并更新该路由记录,默认跳转逻辑不需要同步改字符串。

路由配置的关键不是把所有页面一次性写进一个数组,而是让 URL 层级、页面布局层级和业务导航层级尽量一致。这样嵌套路由才能真正承担页面组织职责,而不是只充当跳转表。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

路由实例与页面映射

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通