4. 路由

4.1. 【对路由的理解】

4.2. 【基本切换效果】

• Vue3 中要使用 vue-router 的最新版本，目前是 4 版本。

• 路由配置文件代码如下：

  import {createRouter,createWebHistory} from 'vue-router'
  import Home from '@/pages/Home.vue'
  import News from '@/pages/News.vue'
  import About from '@/pages/About.vue'
  
  const router = createRouter({
  	history:createWebHistory(),
  	routes:[
  		{
  			path:'/home',
  			component:Home
  		},
  		{
  			path:'/about',
  			component:About
  		}
  	]
  })
  export default router

• main.ts 代码如下：

  import router from './router/index'
  app.use(router)
  
  app.mount('#app')

• App.vue 代码如下

  <template>
    <div class="app">
      <h2 class="title">Vue路由测试</h2>
      <!-- 导航区 -->
      <div class="navigate">
        <RouterLink to="/home" active-class="active">首页</RouterLink>
        <RouterLink to="/news" active-class="active">新闻</RouterLink>
        <RouterLink to="/about" active-class="active">关于</RouterLink>
      </div>
      <!-- 展示区 -->
      <div class="main-content">
        <RouterView></RouterView>
      </div>
    </div>
  </template>
  
  <script lang="ts" setup name="App">
    import {RouterLink,RouterView} from 'vue-router'  
  </script>

4.3. 【两个注意点】

1. 路由组件通常存放在 pages 或 views 文件夹，一般组件通常存放在 components 文件夹。

2. 通过点击导航，视觉效果上“消失”了的路由组件，默认是被卸载掉的，需要的时候再去挂载。

4.4.【路由器工作模式】

1. history 模式

   优点：URL 更加美观，不带有#，更接近传统的网站 URL。

   缺点：后期项目上线，需要服务端配合处理路径问题，否则刷新会有 404 错误。

   const router = createRouter({
     	history:createWebHistory(), //history模式
     	/******/
   })

2. hash 模式

   优点：兼容性更好，因为不需要服务器端处理路径。

   缺点：URL 带有 # 不太美观，且在 SEO 优化方面相对较差。

   const router = createRouter({
     	history:createWebHashHistory(), //hash模式
     	/******/
   })

4.5. 【to的两种写法】

<!-- 第一种：to的字符串写法 -->
<router-link active-class="active" to="/home">主页</router-link>

<!-- 第二种：to的对象写法 -->
<router-link active-class="active" :to="{path:'/home'}">Home</router-link>

4.6. 【命名路由】

作用：可以简化路由跳转及传参。

给路由规则命名：

routes:[
  {
    name:'zhuye',
    path:'/home',
    component:Home
  },
  {
    name:'xinwen',
    path:'/news',
    component:News,
  },
  {
    name:'guanyu',
    path:'/about',
    component:About
  }
]

跳转路由：

<!--简化前：需要写完整的路径（to的字符串写法） -->
<router-link to="/news/detail">跳转</router-link>

<!--简化后：直接通过名字跳转（to的对象写法配合name属性） -->
<router-link :to="{name:'guanyu'}">跳转</router-link>

4.7. 【嵌套路由】

1. 编写 News 的子路由：Detail.vue

2. 配置路由规则，使用 children 配置项：

   const router = createRouter({
     history:createWebHistory(),
     routes:[
       {
         name:'zhuye',
         path:'/home',
         component:Home
       },
       {
         name:'xinwen',
         path:'/news',
         component:News,
         children:[
           {
             name:'xiang',
             path:'detail',
             component:Detail
           }
         ]
       },
       {
         name:'guanyu',
         path:'/about',
         component:About
       }
     ]
   })
   export default router

3. 跳转路由（记得要加完整路径）：

   <router-link to="/news/detail">xxxx</router-link>
   <!-- 或 -->
   <router-link :to="{path:'/news/detail'}">xxxx</router-link>

4. 记得去Home组件中预留一个<router-view>

   <template>
     <div class="news">
       <nav class="news-list">
         <RouterLink v-for="news in newsList" :key="news.id" :to="{path:'/news/detail'}">
           {{news.name}}
         </RouterLink>
       </nav>
       <div class="news-detail">
         <RouterView/>
       </div>
     </div>
   </template>

4.8. 【路由传参】

query 参数

1. 传递参数

   <!-- 跳转并携带query参数（to的字符串写法） -->
   <router-link to="/news/detail?a=1&b=2&content=欢迎你">
       跳转
   </router-link>
                   
   <!-- 跳转并携带query参数（to的对象写法） -->
   <RouterLink 
     :to="{
       //name:'xiang', //用name也可以跳转
       path:'/news/detail',
       query:{
         id:news.id,
         title:news.title,
         content:news.content
       }
     }"
   >
     {{news.title}}
   </RouterLink>

2. 接收参数：

   import {useRoute} from 'vue-router'
   const route = useRoute()
   // 打印query参数
   console.log(route.query)

params 参数

1. 传递参数

   <!-- 跳转并携带params参数（to的字符串写法） -->
   <RouterLink :to="`/news/detail/001/新闻001/内容001`">{{news.title}}</RouterLink>
                   
   <!-- 跳转并携带params参数（to的对象写法） -->
   <RouterLink 
     :to="{
       name:'xiang', //用name跳转
       params:{
         id:news.id,
         title:news.title,
         content:news.title
       }
     }"
   >
     {{news.title}}
   </RouterLink>

2. 接收参数：

   import {useRoute} from 'vue-router'
   const route = useRoute()
   // 打印params参数
   console.log(route.params)

备注1：传递 params 参数时，若使用 to 的对象写法，必须使用 name 配置项，不能用 path。

备注2：传递 params 参数时，需要提前在规则中占位。

4.9. 【路由的 props 配置】

作用：让路由组件更方便的收到参数（可以将路由参数作为 props 传给组件）

{
  name:'xiang',
  path:'detail/:id/:title/:content',
  component:Detail,

  // props的对象写法，作用：把对象中的每一组key-value作为props传给Detail组件
  // props:{a:1,b:2,c:3},

  // props的布尔值写法，作用：把收到了每一组params参数，作为props传给Detail组件
  // props:true

  // props的函数写法，作用：把返回的对象中每一组key-value作为props传给Detail组件
  props(route){
    return route.query
  }
}

4.10. 【replace 属性】

1. 作用：控制路由跳转时操作浏览器历史记录的模式。

2. 浏览器的历史记录有两种写入方式：分别为 push 和 replace：

   • push 是追加历史记录（默认值）。
   • replace 是替换当前记录。

3. 开启 replace 模式：

   <RouterLink replace .......>News</RouterLink>

4.11. 【编程式导航】

路由组件的两个重要的属性：$route 和 $router 变成了两个 hooks

import {useRoute,useRouter} from 'vue-router'

const route = useRoute()
const router = useRouter()

console.log(route.query)
console.log(route.parmas)
console.log(router.push)
console.log(router.replace)

4.12. 【重定向】

1. 作用：将特定的路径，重新定向到已有路由。

2. 具体编码：

   {
       path:'/',
       redirect:'/about'
   }