VUE-CLI/VUE-ROUTER
个人简介
> 个人主页：是Lay的主页
> 学习方向：JAVA后端开发
> 种一棵树最好的时间是十年前，其次是现在！
> ⏰往期文章：【Java基础】面向对象进阶(二)
> 喜欢的话麻烦点点关注喔，你们的支持是我的最大动力。
目录
前言:
1. 安装
1.1 npm安装
1.2 vue-cli安装
2. 初始化项目
2.1 vue init命令讲解
2.2 项目初始化
3. 运行项目
4. 成功页面
5. 项目结构
5.1 总体框架
5.2 配置目录文件详解
5.3 src项目核心文件讲解
6. VUE-ROUTER
6.1 快速入门
6.2 页面跳转
6.3 子路由-路由嵌套
6.4 路由传递参数
6.5 命名路由-命名视图-重定向-别名
前言:
官方文档
vue-cli是vue官方出品的快速构建单页应用的脚手架，里面集成了webpack，npm，nodejs，babel，vue，vue-router
1. 安装
先安装nodejs
配置环境变量
安装vue-cli的前提是你已经安装了npm，在命令行工具中输入npm -v 命令来检测npm的安装以及版本情况。
1.1 npm安装
node下载地址：下载 | Node.js 中文网
安装成功提示：npm -v
配置淘宝镜像
npm config set registry https://registry.npm.taobao.org
1.2 vue-cli安装
全局安装vue-cli，命令行：
npm install vue-cli -g
PS：-g代表全局安装，然后查看版本：
vue -V
PS: 注意这里的V是大写
2. 初始化项目
2.1 vue init命令讲解
用vue init命令来初始化项目，具体使用方法如下：
vue init
init：表示要用vue-cli来初始化项目
- webpack：一个全面的webpack+vue-loader的模板，功能包括热加载，linting,检测和CSS扩展。
- webpack-simple：一个简单webpack+vue-loader的模板，不包含其他功能，让你快速的搭建vue的开发环境。
- browserify：一个全面的Browserify+vueify 的模板，功能包括热加载，linting,单元检测。
- browserify-simple：一个简单Browserify+vueify的模板，不包含其他功能，让你快速的搭建vue的开发环境。
- simple：一个最简单的单页应用模板。
2.2 项目初始化
在实际开发中，一般都会使用webpack这个模板，命令使用如下：
vue init webpack my-vue-demo
Project name：项目名称 ，默认为初始化建项目的名称my-vue-demo，不需要直接回车
Project description：项目描述，默认为A Vue.js project，不需要直接回车
Author：作者，如果有配置git的作者，自动会读取。直接回车
Install vue-router? 是否安装vue的路由插件，需要安装，选择Y
Use ESLint to lint your code? 是否用ESLint来限制你的代码错误和风格。不需要输入n，需要选择y，如果是大型团队开发，最好是进行配置
setup unit tests with Karma + Mocha? 是否需要安装单元测试工具，不需要输入n，需要选择y
Setup e2e tests with Nightwatch? 是否安装e2e来进行用户行为模拟测试，不需要输入n，需要选择y
初始化完成之后会出现以下信息，表示操作成功。
3. 运行项目
cd my-vue-demo，使用cd命令进入到项目目录
npm run dev
以上命令为开发模式下运行项目
npm run build
以上命令为项目发布打包
4. 成功页面
5. 项目结构
5.1 总体框架
一个vue-cli的项目结构如下，其中src文件夹是需要掌握，其余了解即可。
文件夹目录如下：
每个文件夹目录详细说明如下：
5.2 配置目录文件详解
1. build目录（webpack配置）
build文件主要是webpack的配置，目录详情如下：
2. config目录（vue项目配置目录）
config文件主要是项目相关配置，常用的就是当端口冲突时配置监听端口，打包输出路径及命名等，目录详情如下：
3. node_modules（项目依赖包）
node_modules里面是项目依赖包，其中包括很多基础依赖，自己也可以根据需要安装其他依赖。安装方法打开命令工具，进入项目目录，输入npm install [依赖包名称]，回车
在两种情况下我们会自己去安装依赖：
》项目运行缺少该依赖包
》安装插件：如vuex
PS：有时会安装指定依赖版本，需在依赖包名称后加上版本号信息，如npm install [email protected]
5.3 src项目核心文件讲解
核心文件目录前面已经说明了，下面重点讲解index.html，main.js，App.vue，router的index.js，HelloWorld.vue
1. index.html（主页）
index.html为项目的主页，跟其他html一样，但一般只定义一个空的根节点，在main.js里面定义的实例将挂载在根节点下，内容都通过vue组件来填充。说明如下：
my-vue-demo
2. main.js（入口文件）
main.js为项目的入口文件，即单入口，主要是引入vue框架，根组件及路由设置，并且定义vue实例，说明如下：
// 引入vue框架
import Vue from 'vue'
// 引入根组件
import App from './App'
// 引入路由配置
import router from './router'
// 关闭生产模式下给出的提示
Vue.config.productionTip = false
// 定义实例
new Vue({
el: '#app',
router,
components: { App },
template: '3. App.vue（根组件）
一个vue页面通常由三部分组成：模板(template)、js(script)、样式(style)，说明如下：
[template-模板]
（1） 模板只能包含一个父节点，也就是说顶层的div只能有一个（如上图，父节点为#app的div，其没有兄弟节点）
（2）
【script-JS代码】
vue通常用es6来写，用export default导出，其下面可以包含数据data，生命周期(mounted等)，方法(methods)等。
【style-CSS样式】
样式通过style标签包裹，默认是影响全局的，如需定义作用域只在该组件下起作用，需在标签上加scoped，
引入外部CSS示例:
4. router（路由配置）
router文件夹下，有一个index,js的路由配置文件，说明如下：
// 引入vue框架
import Vue from 'vue'
// 引入vue-router路由依赖
import Router from 'vue-router'
// 引入页面组件，命名为HelloWorld
import HelloWorld from '@/components/HelloWorld'
// 使用路由依赖
Vue.use(Router)
// 定义路由配置
export default new Router({
routes: [
{
path: '/',
name: 'HelloWorld',
component: HelloWorld
}
]
})5. HelloWorld.vue（页面组件）
最熟悉的HelloWorld输出，说明如下：
{{ msg }}
6. VUE-ROUTER
官方文档
Vue Router 是 Vue.js 官方的路由管理器。它和 Vue.js 的核心深度集成，让构建单页面应用变得易如反掌。
包含的功能有：
- 嵌套的路由/视图表
- 模块化的、基于组件的路由配置
- 路由参数、查询、通配符
- 基于 Vue.js 过渡系统的视图过渡效果
- 细粒度的导航控制
- 带有自动激活的 CSS class 的链接
- HTML5 历史模式或 hash 模式，在 IE9 中自动降级
- 自定义的滚动条行为
6.1 快速入门
安装
vue-router是一个插件包，需要用npm来进行安装的。如果采用vue-cli构建初始化项目会提示安装，也可以自己使用命令安装：
npm install vue-router --save
解读核心文件
用vue-cli构建项目之后，在src/router/index.js文件中，看到以下的路由核心文件：
// 引入vue框架
import Vue from 'vue'
// 引入vue-router路由依赖
import Router from 'vue-router'
// 引入页面组件，命名为HelloWorld
import HelloWorld from '@/components/HelloWorld'
// Vue全局使用Router
Vue.use(Router)
// 定义路由配置
export default new Router({
routes: [ //配置路由，这里是个数组
{ //每一个链接都是一个对象
path: '/', //链接路径
name: 'HelloWorld', //路由名称，
component: HelloWorld //对应的组件模板
}
]
})使用
在系统入口文件main.js中注入router，代码如下：
// 引入vue框架
import Vue from 'vue'
// 引入根组件
import App from './App'
// 引入路由配置
import router from './router'
// 关闭生产模式下给出的提示
Vue.config.productionTip = false
// 定义实例
new Vue({
el: '#app',
router, // 注入框架中
components: { App },
template: '6.2 页面跳转
1. router-link标签跳转
在html标签内使用router-link跳转，相应于超链接a标签，使用方式如下：
[显示字段] to：导航路径
使用示例如下：
导航 ：
首页
hello
2. 编程式导航-JS代码内部跳转
实际项目中，很多时候都是通过在JS代码内部进行导航的跳转，使用方式如下：
this.$router.push('/xxx')具体的简单用法：
（1）先编写一个按钮，在按钮上绑定goHome( )方法。
（2）在
2. src/components/One.vue（子页面1）
{{ msg }}
3. src/components/Two.vue（子页面2）
{{ msg }}
4. src/router/index.js（路由配置）
import Vue from 'vue'
import Router from 'vue-router'
import Home from '@/components/Home'
import One from '@/components/One'
import Two from '@/components/Two'
Vue.use(Router)
export default new Router({
routes: [
{
path: '/', // 默认页面重定向到主页
redirect: '/home'
},
{
path: '/home', // 主页路由
name: 'Home',
component: Home,
children:[ // 嵌套子路由
{
path:'one', // 子页面1
component:One
},
{
path:'two', // 子页面2
component:Two
},
]
}
]
})5. 效果图
PS：各部分代码都很简单，也有注释，在采用vue-cli初始化项目完成之后直接复制到相应目录即可查看效果。
6.4 路由传递参数
1. 通过
基本语法：
valueString PS：上面to前边是带冒号，后边跟的是一个对象形势的字符串
- name：在路由配置文件中起的name值。叫做命名路由，下一节会讲到。
- params：要传的参数，它是对象形式，在对象里可以传递多个值。
具体实例如下：
（1）在src/components/Home.vue里面导航中添加如下代码：
子页面1 （2）在src/router/indes.js中添加如下代码，重点是name：\
{
path:'one', // 子页面1
name: 'one', // 路由名称-命名路由
component:One
}（3）在src/components/One.vue里面接受参数，代码如下：
{{$route.params.username}}
2. url中传递参数
（1）在路由中以冒号传递，在src/router/index.js中加入如下代码：
{
path:'/home/two/:id/:name', // 子页面2
component:Two
},（2）接受参数，在src/components/Two.vuez中加入如下代码：
ID：{{ $route.params.id}}
名称：{{ $route.params.name}}
（3）路由跳转，在src/components/Home.vue中加入如下代码：
子页面2 PS：to前没有冒号为字符串路由，必须全部匹配。
（4）如果路由参数需要有特定的规则，就需要加入正则表达式了，示例如下：
{
path:'/home/two/:id(\\d+)/:name', // 子页面2
component:Two
}3. 编程式导航-params传递参数
（1）在src/router/index.js页面加入如下代码：
{
path:'/home/three', // 子页面3
name: 'three',
component:Three
}（2）在src/components/Three.vue页面加入如下代码：
ID：{{ $route.params.id}}
名称：{{ $route.params.name}}
（3）在src/components/Home.vue中加入如下代码：
// template
// script
methods: {
toThreePage() {
this.$router.push({name: 'three', params: {id: 1, name: 'zhangsan'}})
}
}说明：
A、动态路由使用params传递参数，在this.$router.push() 方法中path不能和params一起使用，否则params将无效。需要用name来指定页面。
B、以上方式参数不会显示到浏览器的地址栏中，如果刷新一次页面，就获取不到参数了，改进方式将第一部中的代码改成如下：
{
path:'/home/three/:id/:name', // 子页面3
name: 'three',
component:Three
}4. 编程式导航-query传递参数
（1）在src/router/index.js页面加入如下代码：
{
path:'/home/three', // 子页面3
name: 'three',
component:Three
}（2）在src/components/Three.vue页面加入如下代码：
ID：{{ $route.query.id}}
名称：{{ $route.query.name}}
（3）在src/components/Home.vue中加入如下代码：
// template
// script
methods: {
toThreePage() {
this.$router.push({path: '/home/three', query: {id: 1, name: 'zhangsan'}})
}
}PS：动态路由使用query传递参数，会显示到浏览器地址栏中，以上链接为
/home/three?id=1&name=zhangsan
6.5 命名路由-命名视图-重定向-别名
1. 命名路由
给一个路由命一个唯一的名称，然后跳转调用这个名称即可。
（1）在src/router/index.js中加一个带name的路由，代码如下：
{
path: 'one', // 子页面1
name: 'one', // 路由名称-命名路由
component: One // 页面组件
}（2）在src/component/Home.vue页面中调用，代码如下：
// template跳转调用
子页面1
// router.push函数跳转调用
router.push({ name: 'user'}})2. 命名视图
在同一个页面展示多个视图，如果不用嵌套，只能采用命名视图来实现了，代码如下：
（1）在src/router/index.js中，代码如下：
import Vue from 'vue'
import Router from 'vue-router'
// 创建页面组件
const Header = { template: 'Header' }
const Left = { template: 'Left' }
const Right = { template: 'Right' }
Vue.use(Router)
export default new Router({
routes: [
{
path: '/', // 主页路由
components: {
default: Header,
a: Left,
b: Right
}
}
]
})（2）在src/App.vue中，代码如下：
PS：经过实践，命名视图只能放在最顶级的页面中，即第一步中的代码不能放在其他页面中。
3. 重定向
重定向是通过route的配置中关键词redirect来实现的，具体代码如下：
（1）在src/router/index.js中，代码如下：
export default new Router({
routes: [
{
path: '/', // 默认页面重定向到主页
redirect: '/home' // 重定向
},
{
path: '/home', // 主页路由
component: Home,
children:[ // 嵌套子路由
{
path:'/home/two/:id/:name', // 子页面2
component:Two
},
{
path:'/home/three/:id/:name', // 子页面3
name: 'three', // 路由名称-命名路由
redirect: '/home/two/:id/:name' // 重定向-传递参数
},
]
}
]
})（2）在src/components/Home.vue中，代码如下：
首页 |
子页面2 |
子页面3 说明1-不带参数的重定向：
redirect: '/home' // 重定向-不带参数
说明2-带参数的重定向：
redirect: '/home/two/:id/:name' // 重定向-传递参数
4. 别名
重定向是通过route的配置中关键词alias来实现的，具体代码如下：
（1）在src/router/index.js中，代码如下：
{
path:'/one', // 子页面1
component:One,
alias: '/oneother'
}（2）在src/components/Home.vue中，代码如下：
子页面1 说明1：redirect和alias的区别
- redirect：直接改变了url的值，把url变成了真实的path路径。\
- alias：url路径没有别改变，这种更友好，让用户知道自己访问的路径，只是改变了
中的内容。
说明2：
别名请不要用在path为’/’中，如下代码的别名是不起作用的。
{
path: '/',
component: Hello,
alias:'/home'
}