vue路由+vant组件库使用

莫凡是莫烦
1,314 阅读9分钟

1. vue路由简介和基础使用

1.0 什么是路由

设备和ip的映射关系

image-20210512095742920.png

接口和服务的映射关系

image-20210512095805578.png

路径和组件的映射关系 image-20210512095825389.png

1.1 为什么使用路由

目标: 在一个页面里, 切换业务场景

具体使用示例: 网易云音乐 music.163.com/

单页面应用(SPA): 所有功能在一个html页面上实现

前端路由作用: 实现业务场景切换

优点：

  • 整体不刷新页面，用户体验更好
  • 数据传递容易, 开发效率高

缺点：

  • 开发成本高(需要学习专门知识)
  • 首次加载会比较慢一点。不利于seo

1.2 vue-router介绍

目标: 如何在Vue项目中集成路由

官网: router.vuejs.org/zh/

  • 它和 Vue.js 深度集成

  • 可以定义 - 视图表(映射规则)

  • 模块化的

  • 提供2个内置全局组件

  • 声明式导航自动激活的 CSS class 的链接

  • ……

1.3 路由 - 组件分类

目标: .vue文件分2类, 一个是页面组件, 一个是复用组件

.vue文件本质无区别, 总结的一个经验

src/views(或pages) 文件夹 和 src/components文件夹

  • 页面组件 - 页面展示 - 配合路由用
  • 复用组件 - 展示数据/常用于复用

image-20210424215930981.png

总结: views下的页面组件, 配合路由切换, components下的一般引入到views下的vue中复用展示数据

1.4 vue-router使用

目标: 学会vue官方提供的vue-router路由系统功能模块使用

App.vue - 页面标签和样式准备(==可复制继续写==)

<template>
  <div>
    <div class="footer_wrap">
      <a href="#/find">发现音乐</a>
      <a href="#/my">我的音乐</a>
      <a href="#/part">朋友</a>
    </div>
    <div class="top">
      
    </div>
  </div>
</template>
​
<script>
export default {};
</script>
​
<style scoped>
.footer_wrap {
  position: fixed;
  left: 0;
  top: 0;
  display: flex;
  width: 100%;
  text-align: center;
  background-color: #333;
  color: #ccc;
}
.footer_wrap a {
  flex: 1;
  text-decoration: none;
  padding: 20px 0;
  line-height: 20px;
  background-color: #333;
  color: #ccc;
  border: 1px solid black;
}
.footer_wrap a:hover {
  background-color: #555;
}
.top {
  padding-top: 62px;
}
</style>

vue-router文档

  • 安装
yarn add vue-router

main.js

  • 导入路由
import VueRouter from 'vue-router'
  • 使用路由插件
// 在vue中，使用使用vue的插件，都需要调用Vue.use()
Vue.use(VueRouter)
  • 创建路由规则数组
//跳转路径
const routes = [
  {
    path: "/find",
    component: Find
  },
  {
    path: "/my",
    component: My
  },
  {
    path: "/part",
    component: Part
  }
]
  • 创建路由对象 - 传入规则
const router = new VueRouter({
  routes
})
  • 关联到vue实例
new Vue({
  router
})
  • (App.vue) components换成router-view
<router-view></router-view>

接下来在src/views建立三个对应的组件

image.png

补充

如果遇到如下的报错，可能是你的路由版本过高了

image.png 使用指令

npm install vue-router@3.2.0 或者 yarn add vue-router@3.2.0

总结: 下载路由模块, 编写对应规则注入到vue实例上, 使用router-view挂载点显示切换的路由

总结2: 一切都围绕着hash值变化为准

2. vue路由 - 声明式导航

2.0 声明式导航 - 基础使用

目标: 可用全局组件router-link来替代a标签

  1. vue-router提供了一个全局组件 router-link
  2. router-link实质上最终会渲染成a链接 to属性等价于提供 href属性(to无需#)
  3. router-link提供了声明式导航高亮的功能(点击时自带类名)

image.png

<template>
  <div>
    <div class="footer_wrap">
      <router-link to="/find">发现音乐</router-link>
      <router-link to="/my">我的音乐</router-link>
      <router-link to="/part">朋友</router-link>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
export default {};
</script>
​
<style scoped>
/* 省略了 其他样式 */
.footer_wrap .router-link-active{
  color: white;
  background: black;
}
</style>

总结: 链接导航, 用router-link配合to, 实现点击切换路由

2.1 声明式导航 - 跳转传参

目标: 在跳转路由时, 可以给路由对应的组件内传值

在router-link上的to属性传值, 语法格式如下

  • /path?参数名=值
  • /path/值 – 需要路由对象提前配置（main.js） path: “/path/参数名”

image.png

对应页面组件接收传递过来的值

  • $route.query.参数名

  • $route.params.参数名

  1. 创建components/Friends.vue - 准备接收路由上传递的参数和值

    <template>
  <div>
      <p>关注明星</p>
      <p>发现精彩</p>
      <p>寻找伙伴</p>
      <p>加入我们</p>
      <p>人名: {{ $route.query.name }} -- {{ $route.params.username }}</p>
  </div>
</template>

  2. 路由定义

    {
    path: "/friends",
    component: Friends
  },
  {
    path: "/friends/:username", // 有:的路径代表要接收具体的值
    component: Friends
  },

  3. 导航跳转, 传值给Friends.vue组件

    <router-link to="/friends?name=小传">朋友-小传</router-link>
//第一种

<router-link to="/friends/小智">朋友-小智</router-link>

//第二种

（要注意写法，注意？和/使用情况）

总结:

?key=value 用$route.query.key 取值

/值 提前在路由规则/path/:key 用$route.params.key 取值

3. vue路由 - 重定向和模式

3.0 路由 - 重定向

目标: 匹配path后, 强制切换到目标path上

  • 网页打开url默认hash值是/路径
  • redirect是设置要重定向到哪个路由路径

例如: 网页默认打开, 匹配路由"/", 强制切换到"/find"上

const routes = [
  {
    path: "/", // 默认hash值路径
    redirect: "/find" // 重定向到/find
    // 浏览器url中#后的路径被改变成/find-重新匹配数组规则
  }
]

效果输入：http://localhost:8080----->http://localhost:8080/#/find

总结: 强制重定向后, 还会重新来数组里匹配一次规则

3.1 路由 - 404页面

目标: 如果路由hash值, 没有和数组里规则匹配

默认给一个404页面

语法: 路由最后, path匹配*(任意路径) – 前面不匹配就命中最后这个, 显示对应组件页面

  1. 创建NotFound页面

    <template>
  <img src="../assets/404.png" alt="">
</template>
​
<script>
export default {
​
}
</script>
​
<style scoped>
    img{
        width: 100%;
    }
</style>

  2. 在main.js - 修改路由配置

    import NotFound from '@/views/NotFound'
​
const routes = [
  // ...省略了其他配置
  // 404在最后(规则是从前往后逐个比较path)
  {
    path: "*",
    component: NotFound
  }
]

总结: 如果路由未命中任何规则, 给出一个兜底的404页面

3.2 路由 - 模式设置

目标: 修改路由在地址栏的模式

hash路由例如: http://localhost:8080/#/home

history路由例如: http://localhost:8080/home (以后上线需要服务器端支持, 否则找的是文件夹)

模式文档

router/index.js

const router = new VueRouter({
  routes,
  mode: "history" // 打包上线后需要后台支持, 模式是hash
})

image.png (可以看见已经没有#了)

4. vue路由 - 编程式导航

用JS代码跳转, 声明式导航用a标签

4.0 编程式导航 - 基础使用

目标: 用JS代码来进行跳转

语法:

this.$router.push({
    path: "路由路径", // 都去 router/index.js定义
    name: "路由名"
})
  1. main.js - 路由数组里, 给路由起名字
{
    path: "/find",
    name: "Find",
    component: Find
},
{
    path: "/my",
    name: "My",
    component: My
},
{
    path: "/part",
    name: "Part",
    component: Part
},

实际上主要是通过点击事件进行跳转，配合this.$router.push（） 里面的name和path进行传递（两者二选一即可）

image.png 2. App.vue - 换成span 配合js的编程式导航跳转

<template>
  <div>
    <div class="footer_wrap">
      <span @click="btn('/find', 'Find')">发现音乐</span>
      <span @click="btn('/my', 'My')">我的音乐</span>
      <span @click="btn('/part', 'Part')">朋友</span>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
// 目标: 编程式导航 - js方式跳转路由
// 语法:
// this.$router.push({path: "路由路径"})
// this.$router.push({name: "路由名"})
// 注意:
// 虽然用name跳转, 但是url的hash值还是切换path路径值
// 场景:
// 方便修改: name路由名(在页面上看不见随便定义)
// path可以在url的hash值看到(尽量符合组内规范)
export default {
  methods: {
    btn(targetPath, targetName){
      // 方式1: path跳转
      this.$router.push({
        // path: targetPath,
        name: targetName
      })
    }
  }
};
</script>

4.1 编程式导航 - 跳转传参

目标: JS跳转路由, 传参

语法 query / params 任选 一个

this.$router.push({
    path: "路由路径"
    name: "路由名",
    query: {
        "参数名": 值
    }
    params: {
        "参数名": 值
    }
})
​
// 对应路由接收   $route.params.参数名   取值
// 对应路由接收   $route.query.参数名    取值

==格外注意: 使用path会自动忽略params==（所以更推荐使用name）

App.vue

<template>
  <div>
    <div class="footer_wrap">
      <span @click="btn('/find', 'Find')">发现音乐</span>
      <span @click="btn('/my', 'My')">我的音乐</span>
      <span @click="oneBtn">朋友-小传</span>
      <span @click="twoBtn">朋友-小智</span>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
// 目标: 编程式导航 - 跳转路由传参
// 方式1:
// params => $route.params.参数名
// 方式2:
// query => $route.query.参数名
// 重要: path会自动忽略params
// 推荐: name+query方式传参
// 注意: 如果当前url上"hash值和?参数"与你要跳转到的"hash值和?参数"一致, 爆出冗余导航的问题, 不会跳转路由
export default {
  methods: {
    btn(targetPath, targetName){
      // 方式1: path跳转
      this.$router.push({
        // path: targetPath,
        name: targetName
      })
    },
    oneBtn(){
      this.$router.push({
        name: 'Part',
        params: {
          username: '小传'
        }
      })
    },
    twoBtn(){
      this.$router.push({
        name: 'Part',
        query: {
          name: '小智'
        }
      })
    }
  }
};
</script>

（App.vue）精简版 image.png

接收位置（Friends.vue） image.png

效果

image.png

总结: 传参2种方式

query方式

params方式

5. vue路由 - 嵌套和守卫

5.0 vue路由 - 路由嵌套

目标: 在现有的一级路由下, 再嵌套二级路由

二级路由示例-网易云音乐-发现音乐下

router-view嵌套架构图

  1. 创建需要用的所有组件

    src/views/Find.vue -- 发现音乐页

    src/views/My.vue -- 我的音乐页

    src/views/Second/Recommend.vue -- 发现音乐页 / 推荐页面

    src/views/Second/Ranking.vue -- 发现音乐页 / 排行榜页面

    src/views/Second/SongList.vue -- 发现音乐页 / 歌单页面

  2. main.js– 继续配置2级路由

    一级路由path从/开始定义

    二级路由往后path直接写名字, 无需/开头

    嵌套路由在上级路由的children数组里编写路由信息对象

image.png

  1. 说明：

    App.vue的router-view负责发现音乐和我的音乐页面, 切换

    Find.vue的的router-view负责发现音乐下的, 三个页面, 切换

image.png

  1. 配置二级导航和样式(==可直接复制==) - 在Find.vue中
<template>
  <div>
    <!-- <p>推荐</p>
    <p>排行榜</p>
    <p>歌单</p> -->
    <div class="nav_main">
      <router-link to="/find/recommend">推荐</router-link>
      <router-link to="/find/ranking">排行榜</router-link>
      <router-link to="/find/songlist">歌单</router-link>
    </div>
​
    <div style="1px solid red;">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
export default {};
</script>
​
<style scoped>
.nav_main {
  background-color: red;
  color: white;
  padding: 10px 0;
}
.nav_main a {
  text-align: center;
  text-decoration: none;
  color: white;
  font-size: 12px;
  margin: 7px 17px 0;
  padding: 0px 15px 2px 15px;
  height: 20px;
  display: inline-block;
  line-height: 20px;
  border-radius: 20px;
}
.nav_main a:hover {
  background-color: brown;
}
.nav_main .router-link-active{
  background-color: brown;
}
</style>
  1. 配置路由规则-二级路由展示
const routes = [
  // ...省略其他
  {
    path: "/find",
    name: "Find",
    component: Find,
    children: [
      {
        path: "recommend",
        component: Recommend
      },
      {
        path: "ranking",
        component: Ranking
      },
      {
        path: "songlist",
        component: SongList
      }
    ]
  }
  // ...省略其他
]
  1. 说明：

  • App.vue, 外层的router-view负责发现音乐和我的音乐页面切换

  • Find.vue 内层的router-view负责发现音乐下的子tab对应的组件切换

image.png

  • main.js进行组件引入

image.png

  1. 运行 - 点击导航观察嵌套路由在哪里展示

总结: 嵌套路由, 找准在哪个页面里写router-view和对应规则里写children

5.1 声明导航 - 类名区别

目标: router-link自带的2个类名的区别是什么

观察路由嵌套导航的样式

  • router-link-exact-active (精确匹配) url中hash值路径, 与href属性值完全相同, 设置此类名
  • router-link-active (模糊匹配) url中hash值, 包含href属性值这个路径

image.png

5.2 全局前置守卫

目标: 路由跳转之前, 先执行一次前置守卫函数, 判断是否可以正常跳转

使用例子: 在跳转路由前, 判断用户登陆了才能去<我的音乐>页面, 未登录弹窗提示回到发现音乐页面

  1. 在路由对象上使用固定方法beforeEach
语法: router.beforeEach((to, from, next)=>{//路由跳转"之前"先执行这里, 决定是否跳转})
  • 参数1: 要跳转到的路由 (路由对象信息)   目标
  • 参数2: 从哪里跳转的路由 (路由对象信息) 来源
  • 参数3: 函数体 - next()才会让路由正常的跳转切换, next(false)在原地停留, next("强制修改到另一个路由路径上") 注意: 如果不调用next, 页面留在原地
// 场景: 当你要对路由权限判断时

// 例子: 判断用户是否登录, 是否决定去"我的音乐"/my
const isLogin = true; // 登录状态(未登录)
router.beforeEach((to, from, next) => {
  if (to.path === "/my" && isLogin === false) {
    alert("请登录")
    next(false) // 阻止路由跳转
  } else {
    next() // 正常放行
  }
})

总结: next()放行, next(false)留在原地不跳转路由, next(path路径)强制换成对应path路径跳转 (to.path代表要跳转的路径)

扩展知识

1. vant组件库

1.0 vant组件库-介绍

目标: vant是一个轻量、可靠的移动端 Vue 组件库, 开箱即用

vant官网

特点:

  • 提供 70 多个高质量组件，覆盖移动端各类场景
  • 性能极佳，组件平均体积不到 1kb
  • 完善的中英文文档和示例
  • 支持 Vue 2 & Vue 3
  • 支持按需引入和主题定制

1.1 全部引入

目标: 看官网文档, 下载, 引入vant组件库

全部引入, 快速开始:vant-contrib.gitee.io/vant/#/zh-C…

1.全部引入, 快速开始: vant-contrib.gitee.io/vant/#/zh-C…

2.下载Vant组件库到当前项目中

3.在main.js中全局导入所有组件,

4.使用图片组件 – 作为示范的例子

image.png 0. 下载vant组件库到当前项目中

```
yarn add vant -D
```

#### tip:
也许还会报错，类似上面路由的那种（也是版本问题）

别慌，用这句指令
`yarn add  vant@latest-v2 -S`

0. 导入所有组件, 在main.js中

```
import Vue from 'vue';
import Vant from 'vant';
import 'vant/lib/index.css';
​
Vue.use(Vant);
```

0. 使用图片组件（App.vue）

<https://vant-contrib.gitee.io/vant/v2/#/zh-CN/image>

```
<van-image
  round
  width="10rem"
  height="10rem"
  fit="cover"
  src="https://img01.yzcdn.cn/vant/cat.jpeg"
/>
```

1.2 手动按需引入

目标: 只引入使用的组件

image.png 1.手动单独引入, 快速开始: vant-contrib.gitee.io/vant/#/zh-C…

// 方式2: 手动 按需引入
import Imag from 'vant/lib/image'; // Image组件
import 'vant/lib/image/style'; // Image样式
  1. 注册
export default {
  components:{
    VanImage:Imag,
    
    //     [Imag.name]: Imag,  //与上面效果一样

  }
}
  1. 使用
 <van-image
      round
      width="10rem"
      height="10rem"
      fit="cover"
      src="https://img01.yzcdn.cn/vant/cat.jpeg"
    />

1.3 自动按需引入

目标: 按需加载组件

babel-plugin-import 是一款 babel 插件，它会在编译过程中将 import 的写法自动转换为按需引入的方式。

  1. 安装插件(下载 babel-plugin-import)

    yarn add babel-plugin-import -D

  2. 在babel配置文件里 (babel.config.js)

    module.exports = {
  plugins: [
    ['import', {
      libraryName: 'vant',
      libraryDirectory: 'es',
      style: true
    }, 'vant']
  ]
};

  3. 全局注册 - 会自动按需引入

main.js 按需引入某个组件, Vue.use全局注册 - 某个.vue文件中直接使用vant组件

```
import { Image as VanImage } from 'vant';
Vue.use(VanImage);

//VanImage是别名直接用Image也行
// import { Image } from 'vant';
// Vue.use(Image);

```

(一定要重启服务器 yarn serve)

1.4 弹出框使用

目标: 使用弹出框组件

image.png vant-contrib.gitee.io/vant/#/zh-C…

<template>
  <div id="app">
    <van-image
  round
  width="10rem"
  height="10rem"
  fit="cover"
  src="https://img01.yzcdn.cn/vant/cat.jpeg"
/>

  <button @click="tip">提示框</button>



  </div>
</template>

<script>

// 提示框引入（函数调用）
import { Dialog } from 'vant';
export default {

  methods:{
    tip(){
Dialog.confirm({
  title: '提示框',
  message:
    '如果解决方法是丑陋的，那就肯定还有更好的解决方法，只是还没有发现而已。',
})
  .then(() => {
    // on confirm
  })
  .catch(() => {
    // on cancel
  });


    }
  }
}
</script>

<style>
#app {
  font-family: Avenir, Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}
</style>

1.5 表单使用

目标: 使用vant组件里的表单组件

vant-contrib.gitee.io/vant/#/zh-C…

image.png

main.js


// 表单引入
import { Form, Field, Button } from 'vant';

Vue.use(Form);
Vue.use(Field);
Vue.use(Button);

App.vue 使用组件

<template>
  <div id="app">
    <van-image
  round
  width="10rem"
  height="10rem"
  fit="cover"
  src="https://img01.yzcdn.cn/vant/cat.jpeg"
/>


<!-- 表单组件 -->
<van-form @submit="onSubmit">
  <van-cell-group inset>
    <van-field
      v-model="username"
      name="用户名"
      label="用户名"
      placeholder="用户名"
      :rules="[{ required: true, message: '请填写用户名' }]"
    />
    <van-field
      v-model="password"
      type="password"
      name="密码"
      label="密码"
      placeholder="密码"
      :rules="[{ required: true, message: '请填写密码' }]"
    />
  </van-cell-group>
  <div style="margin: 16px;">
    <van-button round block type="primary" native-type="submit">
      提交
    </van-button>
  </div>
</van-form>


  </div>
</template>

<script>

export default {
  data() {
    return {
      username: '',
      password: '',
    };
  },
  methods:{
    onSubmit(values) { // 表单提交事件, values收集表单里的值
      console.log('submit', values);
    },
  }
}
</script>

<style>
#app {
  font-family: Avenir, Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}
</style>
avatar
文章
阅读
粉丝