AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

VUE-CLI/VUE-ROUTER

2022-08-31 187
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 官方文档vue-cli是vue官方出品的快速构建单页应用的脚手架，里面集成了webpack，npm，nodejs，babel，vue，vue-router。

前言:

    官方文档

    vue-cli是vue官方出品的快速构建单页应用的脚手架，里面集成了webpack，npm，nodejs，babel，vue，vue-router
  1. 安装

先安装nodejs

配置环境变量
前言:

    官方文档

    vue-cli是vue官方出品的快速构建单页应用的脚手架，里面集成了webpack，npm，nodejs，babel，vue，vue-router
  1. 安装

先安装nodejs

配置环境变量
image.png
image.png
image.png

安装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

image.png

PS：-g代表全局安装，然后查看版本：

vue -V

PS: 注意这里的V是大写

  1. 初始化项目
    2.1 vue init命令讲解

用vue init命令来初始化项目，具体使用方法如下：

vue init

init：表示要用vue-cli来初始化项目

：表示模板名称，vue-cli官方提供的5种模板：

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

image.png

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

初始化完成之后会出现以下信息，表示操作成功。

image.png

  1. 运行项目

cd my-vue-demo，使用cd命令进入到项目目录

npm run dev

以上命令为开发模式下运行项目

npm run build

以上命令为项目发布打包

  1. 成功页面

image.png

  1. 项目结构

5.1 总体框架
一个vue-cli的项目结构如下，其中src文件夹是需要掌握，其余了解即可。
文件夹目录如下：
每个文件夹目录详细说明如下：

image.png

5.2 配置目录文件详解

  1. build目录（webpack配置）

build文件主要是webpack的配置，目录详情如下：

image.png

  1. config目录（vue项目配置目录）

config文件主要是项目相关配置，常用的就是当端口冲突时配置监听端口，打包输出路径及命名等，目录详情如下：

image.png

  1. node_modules（项目依赖包）

node_modules里面是项目依赖包，其中包括很多基础依赖，自己也可以根据需要安装其他依赖。安装方法打开命令工具，进入项目目录，输入npm install [依赖包名称]，回车

在两种情况下我们会自己去安装依赖：
》项目运行缺少该依赖包
》安装插件：如vuex

PS：有时会安装指定依赖版本，需在依赖包名称后加上版本号信息，如npm install vue-loader@11.1.4

5.3 src项目核心文件讲解
核心文件目录前面已经说明了，下面重点讲解index.html，main.js，App.vue，router的index.js，HelloWorld.vue

  1. index.html（主页）

index.html为项目的主页，跟其他html一样，但一般只定义一个空的根节点，在main.js里面定义的实例将挂载在根节点下，内容都通过vue组件来填充。说明如下：

<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1.0">
    <title>my-vue-demo</title>
  </head>
  <body>
      <!-- 定义的vue实例将挂载在#app节点下 -->
    <div id="app"></div>
  </body>
</html>
  1. main.js（入口文件）

main.js为项目的入口文件，即单入口，主要是引入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: '<App/>'
})
  1. App.vue（根组件）

一个vue页面通常由三部分组成：模板(template)、js(script)、样式(style)，说明如下：

<template>
    <div id="app">
        <img src="./assets/logo.png">
        <router-view/>
    </div>
</template>
 
<!-- js代码 -->
<script>
export default {
    name: 'App'
}
</script>
 
<!-- css样式 -->
<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>

[template-模板]
（1） 模板只能包含一个父节点，也就是说顶层的div只能有一个（如上图，父节点为#app的div，其没有兄弟节点）
（2）<router-view/>是子路由视图插槽，后面的路由页面都显示在此处，相当于iframe

【script-JS代码】
vue通常用es6来写，用export default导出，其下面可以包含数据data，生命周期(mounted等)，方法(methods)等。

【style-CSS样式】
样式通过style标签包裹，默认是影响全局的，如需定义作用域只在该组件下起作用，需在标签上加scoped，

引入外部CSS示例:

import './assets/css/public.css'

  1. router（路由配置）

router文件夹下，有一个index,js的路由配置文件，说明如下：

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
    }
  ]
})
  1. HelloWorld.vue（页面组件）

最熟悉的HelloWorld输出，说明如下：

  <div>
    <!-- 输出变量 -->
    <h1>{{ msg }}</h1>
  </div>
</template>
 
<script>
export default {
  // 定义页面名称，可以不要
  name: 'HelloWorld',
  data () {
    return {
      // 定义变量
      msg: 'HelloWorld'
    }
  }
}
</script>
 
<style scoped>
h1 {
  font-size: 16px;
  font-weight: normal;
}
</style>
  1. 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

解读核心文件

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，代码如下：

import Vue from 'vue'
// 引入根组件
import App from './App'
// 引入路由配置
import router from './router'
 
// 关闭生产模式下给出的提示
Vue.config.productionTip = false
 
// 定义实例
new Vue({
  el: '#app',
  router, // 注入框架中
  components: { App },
  template: '<App/>'
})

6.2 页面跳转

  1. router-link标签跳转

在html标签内使用router-link跳转，相应于超链接a标签，使用方式如下：

[显示字段]
to：导航路径
使用示例如下：

导航 ： 首页hello

  1. 编程式导航-JS代码内部跳转

实际项目中，很多时候都是通过在JS代码内部进行导航的跳转，使用方式如下：

this.$router.push('/xxx')
具体的简单用法：
（1）先编写一个按钮，在按钮上绑定goHome( )方法。

（2）在

    name: 'app',
    methods: {
        goHome(){
            this.$router.push('/home');
        }
    }
}
  1. 其它常用方法

// 后退一步记录，等同于 history.back()
this.$router.go(-1)
// 在浏览器记录中前进一步，等同于 history.forward()
this.$router.go(1)

6.3 子路由-路由嵌套

子路由，也叫路由嵌套，采用在children后跟路由数组来实现，数组里和其他配置路由基本相同，需要配置path和component，然后在相应部分添加<router-view/>来展现子页面信息，相当于嵌入iframe。具体看下面的示例：

  1. src/components/Home.vue（父页面）
    <div class="hello">
        <h1>{{ msg }}</h1>
        <!-- 添加子路由导航 -->
        <p>导航 ：
            <router-link to="/home">首页</router-link> | 
            <router-link to="/home/one">-子页面1</router-link> |
            <router-link to="/home/two">-子页面2</router-link>
        </p>
        <!-- 子页面展示部分 -->
        <router-view/>
    </div>
</template>
 
<script>
export default {
    name: 'Home',
    data () {
        return {
            msg: 'Home Page!'
        }
    }
}
</script>
 
<style scoped>
</style>
  1. src/components/One.vue（子页面1）
    <div class="hello">
        <h1>{{ msg }}</h1>
    </div>
</template>
<script>
export default {
    name: 'One',
    data () {
        return {
            msg: 'Hi, I am One Page!'
        }
    }
}
</script>
 
<style scoped>
</style>
  1. src/components/Two.vue（子页面2）
    <div class="hello">
        <h1>{{ msg }}</h1>
    </div>
</template>
<script>
export default {
    name: 'Two',
    data () {
        return {
            msg: 'Hi, I am Two Page!'
        }
    }
}
</script>
 
<style scoped>
</style>
  1. src/router/index.js（路由配置）
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
            },
        ]
    }
    ]
})
  1. 效果图

image.png

PS：各部分代码都很简单，也有注释，在采用vue-cli初始化项目完成之后直接复制到相应目录即可查看效果。

6.4 路由传递参数

  1. 通过 标签中的to传参

基本语法：

<router-link :to="{name:xxx, params:
{key:value}}">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}}

  1. 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

}

  1. 编程式导航-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

}

  1. 编程式导航-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'}})

  1. 命名视图

在同一个页面展示多个视图，如果不用嵌套，只能采用命名视图来实现了，代码如下：
（1）在src/router/index.js中，代码如下：

import Router from 'vue-router'
// 创建页面组件
const Header = { template: '<div>Header</div>' }
const Left = { template: '<div>Left</div>' }
const Right = { template: '<div>Right</div>' }
 
Vue.use(Router)
 
export default new Router({
    routes: [
    {
        path: '/', // 主页路由
        components: {
            default: Header,
            a: Left,
            b: Right
        }
    }
    ]
})

（2）在src/App.vue中，代码如下：

    <div id="app">
        <router-view />
        <router-view name="a" class="left" />
        <router-view name="b" class="right" />
    </div>
</template>
 
<script>
export default {
    name: 'App'
}
</script>
 
<style>
#app {
    text-align: center;
    color: #2c3e50;
    width: 500px;
    border: 1px solid red;
    margin: 0 auto;
}
 
.left,.right{
    float: left;
    width:48%;
    text-align: center;
    border:1px solid red
}
</style>

PS：经过实践，命名视图只能放在最顶级的页面中，即第一步中的代码不能放在其他页面中。

  1. 重定向

重定向是通过route的配置中关键词redirect来实现的，具体代码如下：
（1）在src/router/index.js中，代码如下：

    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' // 重定向-传递参数

  1. 别名

重定向是通过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'

}

文章标签：
JavaScript
前端开发
开发工具
测试技术
定位技术
网络架构
git
HTML5
移动开发
关键词：
vue vue-router
游客kkedeu7fq6wai
目录
相关文章
Boale_H
|
6月前
|
JavaScript
vue-cli创建vue3+ts项目
vue-cli创建vue3+ts项目
Boale_H
64 0
阿甘兄
|
12月前
|
JavaScript 前端开发
Vue系列教程（17）- 路由（vue-router）
Vue系列教程（17）- 路由（vue-router）
阿甘兄
93 1
渐暖
|
6月前
|
资源调度 JavaScript 前端开发
【vue】vue-cli版本选择和比较（vue-cli3.0新版本如何创建项目）
【vue】vue-cli版本选择和比较（vue-cli3.0新版本如何创建项目）
渐暖
69 1
jcLee95
|
6月前
|
Web App开发 缓存 前端开发
VUE-CLI可选的配置文件vue.config.js
VUE-CLI可选的配置文件vue.config.js
jcLee95
73 0
java冯坚持
|
28天前
|
JavaScript 数据可视化
vue-cli学习一：vue脚手架的 vue-cli2和vue-cli3版本 创建vue项目，vue的初始化详解
这篇文章介绍了如何使用vue-cli 2和3版本来创建Vue项目，并详细说明了两者之间的主要区别。
java冯坚持
75 5
vue-cli学习一：vue脚手架的 vue-cli2和vue-cli3版本 创建vue项目，vue的初始化详解
java冯坚持
|
28天前
|
JavaScript 数据可视化
vue-cli学习二：vue-cli3版本 创建vue项目后，Runtime-Compiler和Runtime-only两个模式详解；vue项目管理器；配置文件的配置在哪，以及如何配置
这篇文章详细介绍了Vue CLI 3版本创建项目时的Runtime-Compiler和Runtime-only两种模式的区别、Vue程序的运行过程、render函数的使用、eslint的关闭方法，以及Vue CLI 2和3版本配置文件的不同和脚手架3版本创建项目的配置文件配置方法。
java冯坚持
30 3
vue-cli学习二：vue-cli3版本 创建vue项目后，Runtime-Compiler和Runtime-only两个模式详解；vue项目管理器；配置文件的配置在哪，以及如何配置
刘大猫.
|
14天前
|
资源调度 JavaScript 前端开发
vue3第一章基础：创建Vue3.0工程，包括使用vue-cli 创建、使用 vite 创建
vue3第一章基础：创建Vue3.0工程，包括使用vue-cli 创建、使用 vite 创建
刘大猫.
21 5
刘大猫.
|
1月前
|
JSON 缓存 JavaScript
vue尚品汇商城项目-day01【1.vue-cli脚手架初始化项目生成文件的介绍】
vue尚品汇商城项目-day01【1.vue-cli脚手架初始化项目生成文件的介绍】
刘大猫.
30 0
刘大猫.
|
1月前
|
JavaScript
vue尚品汇商城项目-day01【2.vue-cli脚手架初始化项目的其他配置】
vue尚品汇商城项目-day01【2.vue-cli脚手架初始化项目的其他配置】
刘大猫.
28 0
yqd666
|
4月前
|
JavaScript 前端开发 程序员
Vue组件化、单文件组件以及使用vue-cli(脚手架)
Vue组件化、单文件组件以及使用vue-cli(脚手架)
yqd666
88 0

热门文章

最新文章

  • 1
    VS Code书写vue项目配置 eslint+prettier 统一代码风格
  • 2
    如何在 Vue 中使用 Chart.js - 手把手教你搭可视化数据图表
  • 3
    一文梳理Vue3核心原理
  • 4
    自己设计的Vue3的实用项目（内含对项目亮点的实现思路与介绍）（上）
  • 5
    Vue报错Interpolation inside attributes has been removed.解决方法
  • 6
    新建Vue项目
  • 7
    Vue 报错Failed to mount component: template or render function not defined
  • 8
    [记录] 使用Vue-cli搭建项目教程
  • 9
    Vue路由和Node.js环境搭建
  • 10
    Vue小项目01——标签记录器
  • 1
    在Vue中，子组件向父组件传递数据
    72
  • 2
    【vue3】Argumnt of type ‘history:RouterHistory；}is not assignable to paraeter of type ‘RouterOptions‘.
    95
  • 3
    【vue3】vue3中路由hash与History的设置
    204
  • 4
    【Vue3】解决电脑分辨率125%、150%及缩放导致页面变形的问题
    1076
  • 5
    【vue】 el-table解决分页不能筛选全部数据的问题
    447
  • 6
    【vue】 vue2 监听滚动条滚动事件
    140
  • 7
    【天地图】vue 天地图 T is not defined
    167
  • 8
    【vue】 Tinymce 数据 回显问题 | 第一次正常回显后面，显示空白bug不能编辑
    590
  • 9
    【vue】el-dialog 内的tinymce弹窗被遮挡的解决办法 及 tinymce打开弹出菜单后直接关闭对话组件，导致该弹出菜单残留
    313
  • 10
    【vue】自定义指令实现 复制、长按、水印 功能
    315

    • 相关课程

    更多
  • Spring Boot+Vue.js+FastDFS实现分布式图片服务器
  • Vue.js 入门与实战
  • Vue.js完全自学手册图文教程
  • React 入门与实战

    • 相关电子书

    更多
  • Vue.js 在前端服务化上的探索与实践
  • 利用编译将 Vue 组件转成 React 组件
  • Vue.js在前端服务化上的实践与探索
    • 下一篇
    DataWorks售前咨询