Vue框架快速入门

雨点打透心脏的1/2处 2022-06-07 08:59 244阅读 0赞

Vue是现在最流行的前端框架之一，而且相对于其他两个框架React和Angular来说也更加易学，而且它的作者是国人，中文文档也很完善。当然Vue框架算是比较高级的框架，所以在使用过程中还需要JavaScript、JavaScript 2015、WebPack、NodeJS、npm、ESLint、JavaScript单元测试框架等其他知识和框架的使用方法。在学习Vue之前，最好先学习一下这些知识。由于Vue的中文文档比较完善，所以这里只介绍Vue框架的一些核心概念，详细的使用方法还得查看官方文档。

Vue的中文文档可以查看[https://cn.vuejs.org/v2/guide/installation.html][https_cn.vuejs.org_v2_guide_installation.html] 。

Vue路由功能需要导入vue-router，它的中文文档可以查看[https://router.vuejs.org/zh-cn/][https_router.vuejs.org_zh-cn] 。

Vue的状态管理功能需要使用vuex，它的中文文档可以查看[https://vuex.vuejs.org/zh-cn/][https_vuex.vuejs.org_zh-cn] 。

如果需要更多Vue资料，可以查看[awesome-vue][]，列举了很多Vue资源。

## Vue基本概念 ##

### 从单文件开始 ###

首先，我们来抛开那些复杂的框架配置，先从单文件开始学习Vue最基本的内容。这样做很简单，讲下面的代码复制为一个HTML文件，在浏览器中打开即可。这里引用了Vue框架的CDN，所以不需要任何配置即可使用Vue。

<!DOCTYPE html>
    <html>
    <head>
      <meta charset="UTF-8">
      <title>Vue单文件例子</title>
      <script src="https://cdn.jsdelivr.net/npm/vue"></script>
    </head>
    <body>
    </body>
    </html>

### Vue实例 ###

Vue框架中最重要的东西就是Vue实例了，它是Vue框架的核心对象。在创建Vue实例的时候需要传入一些参数，`el`参数是Vue实例的作用范围；`data`参数是Vue实例使用的数据。在Vue实例对应的元素中，我们可以使用模板语法`{ {var}}`来使用这些数据。

<h1>Vue实例</h1> <div id="s1"> <p>{ { data}}</p> </div> <script> let vm1 = new Vue({ el: '#s1', data: { data: '一些数据' } }) </script>

### 模板语法 ###

#### 文本插值 ####

上面已经展示了一个小例子。文本需要写在两对花括号之间。当然这里其实不止可以写单个变量，还可以写组合表达式，例如`{ {text + new Date()}}`。

所有在构造Vue实例是传入的数据都是可响应的，也就是说只要数据发生改变，那么视图的数据也会发生改变。如果希望数据不发生改变，需要使用`v-once`指令。所有`v-`开头的都是Vue独有的指令，这些指令将在后面介绍。

#### HTML插值 ####

有时候需要操作原始HTML，Vue也提供了支持。要插入的HTML代码需要使用`v-html`指令来指定，这个指令会将它所在的HTML代码块整个替换为要插入的HTML块。由于可能导致XSS攻击，所以最好不要随便替换HTML块。另外要替换HTML块的话只能使用`v-html`指令，如果使用前面的文本插值的话，插入的只是一段文本。

#### 属性 ####

文本插值只能插入文本，如果需要设置和修改HTML属性的话，需要使用`v-bind`指令。

下面是一个简单的例子，将它复制到前面的HTML文件中即可看到效果。

<h1>模板语法</h1> <div id="s2"> <button v-on:click='changeText'>修改文本</button> <p>文本：{ { text}}</p> <p>组合表达式：</p> <p v-once>只渲染一次的文本:{ { text}}</p> <p>HTML代码：<span v-html="html"></span></p> <p>属性: <button v-bind:disabled="disabled">禁用按钮</button> </p> </div> <script> let vm2 = new Vue({ el: '#s2', data: { text: 1, html: '<del>666</del>', disabled: true }, methods: { changeText: function (event) { this.text += 1 } } }) </script>

### 计算属性 ###

有时候程序逻辑比较复杂，可能需要对一个数据进行一些计算和处理。这时候就需要计算属性了。当然由于模板语法支持表达式，所以也可以直接在`{ {}}`中编写表达式，但是不管从可读性还是可维护的角度来说，计算属性都是更好的选择。

计算属性需要在构造Vue实例的时候传入`computed`属性，然后在相应的函数中处理复杂逻辑。计算属性可以向普通属性那样在视图中使用。计算属性有个优点就是惰性求值，下面的例子中，`toUpper`计算属性依赖于`words`属性，只要`words`不发生改变，那么多次访问`toUpper`不会重新出发计算，而是会使用已有的结果。只有当`words`发生变化时，`toUpper`才会相应改变。

<h1>计算属性</h1> <div id="s3"> <p>单词：{ { words}}</p> <p>单词大写：{ { toUpper}}</p> </div> <script> let vm3 = new Vue({ el: '#s3', data: { words: 'I love you' }, computed: { toUpper: function () { return this.words.toUpperCase() } } }) </script>

### Vue指令 ###

#### v-once ####

这个指令让视图只渲染一次，将来就算相应的数据发生变化，也不会重新渲染。该指令主要在希望静态显示不需要更新数据的时候使用。

#### v-html ####

这个指令主要在需要操作原始HTML的时候使用。

#### v-bind ####

该指令在需要绑定HTML标签属性的时候使用。为了方便，该指令还有一个缩写`:`，例如`:class="myClass"`就相当于`v-bind:class="myClass"`。

#### v-on ####

该指令主要用于绑定事件处理程序。该指令有缩写`@`，例如`@click="onClick"`就相当于`v-on:click="onClick"`。

#### v-show、v-if、v-else和v-else-if ####

这几个指令主要用于条件渲染，将在后面进行介绍。

#### v-for ####

该指令用于渲染整个列表，将在后面进行介绍。

#### v-model ####

该指令可以让页面元素和数据进行双向绑定。默认情况下数据和页面元素是单向绑定的，使用该指令可以让其变成双向绑定。该指令主要用于处理表单等场景。

### 条件渲染 ###

v-if、v-else和v-else-if这几个指令用于条件渲染，让我们可以按照条件在页面上显示和隐藏某些元素。注意v-else-if指令是Vue 2.1新增的。类似的指令还有v-show，不过v-show指令仅仅改变元素的CSS display属性，也是说隐藏的元素还是存在于页面上，仅仅是不显示而已。而v-if等元素会真正创建和销毁元素。

这些指令的使用方法很简单，直接看例子就行了。

<h1>条件渲染</h1>
    
    
    <div id="s4">
      <h3>v-if渲染会实际创建和销毁对象</h3>
      <p>分数是:<input type="text" v-model="mark"/></p>
      <p v-if="mark < 60">不及格</p>
      <p v-else-if="mark <80">及格</p>
      <p v-else="">优秀</p>
      <h3>v-show仅仅调用CSS display属性</h3>
      <button @click="toggleShow">改变show状态</button>
      <p v-show="show">可以看到我</p>
    </div>
    <script> let vm4 = new Vue({ el: '#s4', data: { mark: 80, show: true }, methods: { toggleShow: function () { this.show = !this.show } } }) </script>

### 列表渲染 ###

如果需要渲染一组数据，可以使用v-for指令。v-for指令需要一个`item in items`块来声明迭代那些数据，这里`in`也可以改为`of`。如果需要获取迭代的索引的话，可以把迭代块声明为`(item, index) in items`这样的。另外除了迭代一个列表，也可以迭代一个对象的属性。

<h1>列表渲染</h1> <div id="s5"> <h3>名字列表</h3> <ul> <li v-for="name in names">{ { name}}</li> </ul> <h3>人物表格</h3> <table> <thead> <tr> <td>编号</td> <td>姓名</td> <td>年龄</td> </tr> </thead> <tbody> <tr v-for="(person, index) of people" :key="index"> <td>{ { index}}</td> <td>{ { person.name}}</td> <td>{ { person.age}}</td> </tr> </tbody> </table> </div> <script> let vm5 = new Vue({ el: '#s5', data: { names: [ 'zhang3', 'li4', 'yitian', 'jojo' ], people: [ {name: 'zhang3', age: 24}, {name: 'li4', age: 25}, {name: 'yitian', age: 24}, {name: 'jojo', age: 30} ] } }) </script>

### 事件处理 ###

v-on指令用于绑定事件处理函数，这里的函数需要在构造Vue实例的时候在`methods`属性中声明。

针对键盘按键，Vue还定义了一组按键修饰别名，详情请参考官方文档。下面是一个简单的例子。

<h1>事件处理</h1> <div id="s6"> <h3>计数器</h3> <p> <button @click="addCount">增加计数</button> <em>{ { count}}</em> </p> <h3>获取按键(单击、回车和空格)</h3> <input type="text" @keyup.enter="alert('按下了回车')" @keyup.space="alert('按下了空格')" @click="alert('单击')"/> </div> <script> let vm6 = new Vue({ el: '#s6', data: { count: 0 }, methods: { addCount: function () { this.count++ } } }) </script>

### 绑定表单 ###

如果要将数据和页面元素进行双向绑定，使用v-model指令。这个指令主要用于处理表单输入中。下面是一组表单例子。

<h1>绑定表单</h1> <div id="s7"> <p>文本框：{ { text}}</p> <p>多行文本：{ { textArea}}</p> <p>单选按钮：{ { radio}}</p> <p>复选框：{ { checkbox}}</p> <p>多选框：{ { select}}</p> <hr> <p>文本框：<input type="text" v-model="text"></p> <p>多行文本：<textarea v-model="textArea"></textarea></p> <p>单选按钮：<input type="radio" v-model="radio" value="1" id="one"><label for="one">1</label> <input type="radio" value="2" v-model="radio" id="two"><label for="two">2</label> </p> <p>复选框：<input type="checkbox" v-model="checkbox" id="checkbox"><label for="checkbox">复选框</label></p> <p>多选框：<select id="select" v-model="select"> <option value="1">1</option> <option value="2">2</option> <option value="3">3</option> <option value="4">4</option> </select> </p> </div> <script> let vm7 = new Vue({ el: '#s7', data: { text: 'text', textArea: 'textArea', radio: '', checkbox: '', select: '', } }) </script>

在处理表单输入的时候，还有`.lazy`、`.number`、`.trim`几个修饰符，它们的作用分别是在change事件中更新、将表单输入转换为数值以及去掉表单中的前后空格。

### 组件 ###

前面介绍了Vue的各种功能，但是这些功能并不能直接在项目中使用。因为如果直接使用的话，会导致出现一个非常大的Vue实例，这和将所有代码都写在一个文件的道理是一样的。所以Vue引入了组件来进行模块化功能。

定义组件和定义一个Vue实例类似。不同的是，组件需要有自己的模板，而且组件的`data`属性必须是一个函数。原因是假如一个组件在多个地方复用，那么原本的`data`属性会导致所有组件实例共用一个属性值。使用函数后，每个组件实例都会有自己独立的数据。更加详细的解释和例子请查看官方文档。

let component1 = {
        template: '<h3>{
       {hello}}</h3>',
        data() { return { hello: 'hello world' }
        }
      }

定义好了组件之后，我们还需要在Vue中注册它。第一种方法是全局注册，这样组件就可以在全局范围中使用。

Vue.component('组件标签名', {
      //实际组件
    })

第二种方法更常见，就是局部注册。将组建注册到局部Vue实例，那么组件只会在该实例的作用域内可见。局部注册需要在创建Vue实例的时候讲组件传入到`components`属性中。

let vm8 = new Vue({
        el: '#s8',
        components: {
          'hello-world': component1,
        }
      })

组件注册完毕之后，我们就可以像使用自定义标签一样使用它了。

<hello-world></hello-world>

如果需要从父组件中传递数据，需要在子组件中声明`props`属性制定要传入的数据。

let component1 = { template: '<p>{ { hello}} { { name}}</p>', data() { return { hello: 'hello world' } }, props: [ 'name' ] }

然后就可以像这样传递数据了。

<hello-world name="zhang3"></hello-world>

如果需要传递动态数据，使用`v-bind`指令即可。

<hello-world :name="name"></hello-world>

一个完整的例子见下。

<h1>组件</h1>
    <div id="s8">
      <h3>hello world组件</h3>
      <hello-world></hello-world>
      <h3>从父组件传递数据</h3>
      <hello-world name="zhang3"></hello-world>
      <h3>动态传递数据</h3>
      <hello-world :name="name"></hello-world>
    </div>
    <script> let component1 = { template: '<p>{ {hello}} { {name}}</p>', data() { return { hello: 'hello world' } }, props: [ 'name' ] } let vm8 = new Vue({ el: '#s8', data: { name: 'yitian' }, components: { 'hello-world': component1, } }) </script>

### 过渡效果 ###

最后来说说Vue的过渡效果，这里只说说最基本的进入离开过渡。Vue还支持更加复杂的状态过渡，如果想了解这些更复杂的知识，请直接查看文档。

Vue封装了一个组件`transition`，当其中的组件被插入、删除，或者发生变化的时候，会自动查看这些组件是否应用了过渡CSS类，然后再恰当的时机插入和删除这些类，从而实现过渡效果。过渡类名在官方文档中有介绍，还有一张过渡示意图，这里我就不再介绍了。

比如说我现在需要一个透明度过渡效果。我可以这样编写CSS类。

.v-enter-active { transition: all 1s; }
    
        .v-leave-active { transition: all 1s; }
    
        .v-enter, .v-leave-to { opacity: 0; }

然后用下面的方法使用，就可以看到实际效果了。

<div id="s9">
      <h3>按钮过渡</h3>
      <button @click="show = !show">改变状态</button>
      <transition>
        <p v-if="show">Hello</p>
      </transition>
    </div>
    <script> let vm9 = new Vue({ el: '#s9', data: { show: true } })

当然对于我这种前端小白来说，自己编写过渡和动画效果还是有点困难。幸好有很多第三方动画库，而且Vue允许我们自定义类名，以便和这些动画库配合使用。比方说[Animate.css][]，我们可以将CDN添加到页面中来使用。

然后自定义类名即可。

<transition enter-active-class="animated fadeInLeft"
                  leave-active-class="animated fadeOutUpBig">
        <p v-if="show">Hello</p>
      </transition>

完整的单文件例子可以查看[我的示例项目][Link 1]。

## Vue工程化 ##

前面介绍了Vue的基本概念，但是这些概念无法直接用在项目中。下面通过Vue和各种工具链的使用，来介绍如何用Vue创建实际前端项目。

### 从模板创建Vue项目 ###

首先确保你安装了NodeJS，然后安装Vue命令行工具。如果npm速度太慢的话，可以使用[淘宝镜像][Link 2]来加速。

npm install -g vue-cli

安装完成之后，使用`vue-cli`来创建模板项目。由于WebPack打包工具现在非常流行，所以这里选择创建WebPack模板。创建的时候除了Vue之外，其他组件如vue-router、eslint等都不要选。

vue init webpack your-app-name

项目创建完毕之后，切换到项目文件夹中，可以看到已经生成了一堆文件。然后我们使用`npm i`来安装所有的依赖包。安装完成之后，使用`npm run dev`来运行测试服务器。这个项目模板支持热重载等特性，所以我们接下来的开发过程可以直接在此基础上进行，不需要重启服务器。这时候我们也可以使用WebStorm的开发工具编辑项目，充分享受IDE带来的便捷。

下面介绍一下模板项目的结构。build和config文件夹存放的是项目的构建文件和配置文件，会有WebPack和npm使用。node\_modules是项目所需的模块存放位置。src文件夹下存放着项目所需的源代码，主要是JavaScript和Vue文件。assets文件夹存放的是项目所需的静态文件，例如图片、样式表等。components文件夹是Vue组件的存放位置。App.vue是项目默认的跟组件。main.js是项目的入口JavaScript文件。index.html是项目的默认HTML文件。图里面还有一个sample.html，就是上面我介绍Vue时使用的单HTML文件。

![项目结果图][1240]

### 单文件组件 ###

前面介绍了Vue强大的组件功能，但是这种组件是不能扩展的。一般情况下，项目中应该使用单文件组件。在上面创建的项目中，实际上已经包含了一个单文件组件。让我们看看实际的项目应该如何组织这些组件。

先来看看主HTML文件`index.html`，它的内容很简单。它的真实内容会由WebPack打包进去。一般情况下我们只需要保持不变就好了。当然页面标题之类的属性还是要改的。

<!DOCTYPE html>
    <html>
      <head>
        <meta charset="utf-8">
        <title>vue-sample</title>
      </head>
      <body>
        <div id="app"></div>
        
      </body>
    </html>

然后来看看项目入口文件`main.js`，它的内容如下。可以看到它的作用很简单，创建根Vue实例，并将根应用组件`App`注入其中。

import Vue from 'vue'
    import App from './App'
    
    Vue.config.productionTip = false
    
    /* eslint-disable no-new */
    new Vue({
      el: '#app',
      template: '<App/>',
      components: { App }
    })

然后来看看根组件`App.vue`中写了什么，这是一个单文件组件，它调用了另一个单文件组件`<hello-world/>`。单文件组件和前面介绍的组件一样，都有一个模板属性，需要注意模板属性中的元素必须有一个根元素，不能出现多个并列的元素。还有一个脚本块，这里是单文件组件中代码逻辑部分，需要注意的是，这个地方必须向外暴露创建Vue实例所需的那个属性对象。这里还有一个样式块，是单文件组件修改样式的地方。

<template>
      <div id="app">
        <img src="./assets/logo.png">
        <hello-world/>
      </div>
    </template>
    
    <script> import HelloWorld from './components/HelloWorld' export default { name: 'app', components: { HelloWorld } } </script>
    
    <style> ... </style>

## Vue路由快速入门 ##

### 安装 ###

最简单的办法就是在前面创建模板项目的时候同时选择使用vue-router。如果没有在创建项目是选择vue-router，就需要手动添加到项目中。

下面用前面创建的没有安装vue-router的模板项目做例子来介绍。首先需要安装vue-router并将其添加到`package.json`文件中。

npm i -S vue-router

然后创建`src/router/index.js`文件，并在其中添加如下代码。这样会在全局注册Vue路由组件。

import Vue from 'vue'
    import Router from 'vue-router'
    
    Vue.use(Router)
    
    export default new Router()

最后在项目入口文件`src/main.js`中在全局Vue实例中注册路由。

import Vue from 'vue'
    import App from './App'
    import router from './router'
    
    Vue.config.productionTip = false
    
    /* eslint-disable no-new */
    new Vue({
      el: '#app',
      router,
      template: '<App/>',
      components: {App}
    })

这样Vue路由功能就注册好了。

### 添加路由 ###

下面来添加第一个路由。和Vue实例一样，router实例也可以在构造的时候通过参数来配置。首先在路由构造函数中添加路由属性，每个路由都需要有路径、组件名以及实际组件。

import Vue from 'vue'
    import Router from 'vue-router'
    import HelloWorld from '@/components/HelloWorld'
    
    Vue.use(Router)
    
    export default new Router({
      routes: [
        {
          path: '/',
          name: 'Hello',
          component: HelloWorld
        },
      ],
    })

添加好路由之后，为了能让程序随路由变化而显示不同内容，我们还需要使用vue-router预设的组件`<router-view/>`，它会在运行的时候替换为我们所定义的组件。在这个例子中，只需要将`App.vue`文件中的`hello-world`组件替换为`router-view`即可。

### 切换为HTML5历史模式 ###

在使用Vue路由的时候，我们会发现浏览器中的地址长的是这个样子：`xxx/#/`。这是Vue路由的默认哈希模式，优点就是兼容性强。还有另外一种模式就是HTML历史模式。要使用这种模式很简单，在构造Vue路由的时候，将`mode`参数设置为`history`即可。这样一来，浏览器地址栏就会变成正常状态。当然这种模式也有缺点，就是假如后台没配置好，访问某些页面可能会返回404错误。所以具体使用哪种模式还需要自己仔细考虑。

export default new Router({
      routes: [
        {
          path: '/',
          name: 'Hello',
          component: HelloWorld
        },
      ],
      mode: 'history'
    })

Vue路由相对于Vue核心框架来说，没什么复杂的概念，基本上很容易理解和上手。所以我这里就不做过多介绍了。官方文档介绍的更加完整。

## Vue和视图框架 ##

通过以上学习我们可以看到Vue可以算是一个MVVM框架，主要作用就是将前台页面和数据绑定起来。为了做出漂亮的视觉效果，我们还需要和其他视图框架进行集成。

### 和Bootstrap 4集成 ###

Bootstrap是最著名的前端框架之一，可以帮助我们迅速创建漂亮的页面。现在它的最新版本是`4.0.0-beta`，基本可以在项目中投入使用了。现在假设我们有一个启用了路由功能的基于WebPack的Vue模板项目，来看看如何安装Bootstrap 4吧。

首先，用npm安装Bootstrap 4和相关的几个依赖包。这里特别注意Bootstrap的版本，这里我们用的是4 。如果不加版本号的话，会安装3的稳定版。不过现在稳定版已经停止更新了，不会再添加任何新功能了，只进行bug修复和维护。

npm install -S bootstrap@4.0.0-beta jquery popper.js

安装好之后，还需要修改WebPack配置文件。在Vue模板中，配置文件有三个，`webpack.base.conf.js`、`webpack.dev.conf.js`和`webpack.prod.conf.js`，分别代表基础配置、开发配置和生产配置。为了让配置在所有条件下生效，我们需要在`webpack.base.conf.js`中配置。办法也很简单，添加`plugins`属性和下面的插件即可。如果在该文件中没有导入`webpack`模块，还需要在开头添加一行`const webpack = require('webpack')`导入该模块。

plugins: [
        ...
          new webpack.ProvidePlugin({
            $: 'jquery',
            jQuery: 'jquery',
            'window.jQuery': 'jquery',
            Popper: ['popper.js', 'default'],
          })
        ...
      ]

然后在项目入口文件`src/main.js`中引入Bootstrap的样式文件和JavaScript文件即可。

import Vue from 'vue'
    import App from './App'
    import router from './router'
    // 引入Bootstrap文件
    import 'bootstrap'
    import 'bootstrap/dist/css/bootstrap.min.css'
    
    Vue.config.productionTip = false
    
    /* eslint-disable no-new */
    new Vue({
    ...
    })

最后别忘了在`index.html`中添加Bootstrap的meta标签。

然后在页面中就可以使用Bootstrap样式来开发程序了。

![Bootstrap效果图][Bootstrap]

### 和ElementUI集成 ###

[element-ui][]是Vue 2.0的一组组件库，可以帮助我们快速开发项目。

首先通过npm安装。

npm i element-ui -S

然后在`main.js`文件中写入以下内容。

import Vue from 'vue'
    import ElementUI from 'element-ui'
    import 'element-ui/lib/theme-default/index.css'
    import App from './App.vue'
    
    Vue.use(ElementUI)
    
    new Vue({
      el: '#app',
      render: h => h(App)
    })

element-ui的效果如图。

![element-ui效果图][element-ui 1]

[https_cn.vuejs.org_v2_guide_installation.html]: https://cn.vuejs.org/v2/guide/installation.html
[https_router.vuejs.org_zh-cn]: https://router.vuejs.org/zh-cn/
[https_vuex.vuejs.org_zh-cn]: https://vuex.vuejs.org/zh-cn/
[awesome-vue]: https://github.com/vuejs/awesome-vue
[Animate.css]: https://daneden.github.io/animate.css/
[Link 1]: https://github.com/techstay/front-study/blob/master/vue-study/vue-sample/sample.html
[Link 2]: https://npm.taobao.org/
[1240]: /images/20220607/02073adb1b534d9087bfa3992af70bcd.png
[Bootstrap]: /images/20220607/5bda8047f2b846168c75075ffd33b822.png
[element-ui]: http://element.eleme.io/#/zh-CN
[element-ui 1]: /images/20220607/d60cd4af91fb4cf79b7826d6e63c546e.png