V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
kodo
V2EX  ›  Vue.js

vue2.0 构建单页应用最佳实战

  •  1
     
  •   kodo · 2016-11-29 12:36:35 +08:00 · 18528 次点击
    这是一个创建于 2946 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

    我们将会选择使用一些 vue 周边的库vue-cli, vue-router,vue-resource,vuex

    1.使用 vue-cli 创建项目

    2.使用 vue-router 实现单页路由

    3.用 vuex 管理我们的数据流

    4.使用 vue-resource 请求我们的 node 服务端

    5.使用.vue 文件进行组件化的开发

    PS :本文 node v6.2.2 npm v3.9.5 vue v2.1.0 vue-router v2.0.3 vuex v2.0.0

    最终我们将会构建出一个小 demo ,不废话,直接上图。

    安装

    1.我们将会使用 webpack 去为我们的模块打包,预处理,热加载。如果你对 webpack 不熟悉,它就是可以帮助我们把多个 js 文件打包为 1 个入口文件,并且可以达到按需加载。这就意味着,我们不用担心由于使用太多的组件,导致了过多的 HTTP 请求,这是非常有益于产品体验的。但我们并不只是为了这个而使用 webpack ,我们需要用 webpack 去编译.vue 文件,如果没有使用一个 loader 去转换我们.vue 文件里的 style 、 js 和 html ,那么浏览器就无法识别。

    2.模块热加载是 webpack 的一个非常碉堡的特性,将会为我们的单页应用带来极大的便利。 通常来说,当我们修改了代码刷新页面,那应用里的所有状态就都没有了。这对于开发一个单页应用来说是非常痛苦的,因为需要重新在跑一遍流程。如果有模块热加载,当你修改了代码,你的代码会直接修改,页面并不会刷新,所以状态也会被保留。

    3.Vue 也为我们提供了 CSS 预处理,所以我们可以选择在.vue 文件里写 LESS 或者 SASS 去代替原生 CSS 。

    4.我们过去通常需要使用 npm 下载一堆的依赖,但是现在我们可以选择 Vue-cli 。这是一个 vue 生态系统中一个伟大创举。这意味着我们不需要手动构建我们的项目,而它就可以很快地为我们生成。

    首先,安装 vue-cli 。(确保你有 node 和 npm)

    npm i -g vue-cli

    然后创建一个 webpack 项目并且下载依赖

    vue init webpack vue-tutorial

    cd vue-tutorial

    npm i

    接着使用 npm run dev 在热加载中运行我们的应用

    这一行命令代表着它会去找到package.jsonscripts对象,执行node bulid/dev-server.js。在这文件里,配置了 Webpack ,会让它去编译项目文件,并且运行服务器,我们在localhost:8080即可查看我们的应用。

    这些都准备好后,我们需要为我们的路由、 XHR 请求、数据管理下载三个库,我们可以从 vue 的官网中找到他们。另外我们使用bootstrap作为我的 UI 库

    npm i vue-resource vue-router vuex bootstrap --save

    初始化( main.js )

    查看我们的应用文件,我们可以在 src 目录下找到App.vuemain.jsmain.js将会作为我们应用的入口文件而App.vue会作为我们应用的初始化组件。先让我们来完善下main.js

    // src/main.js
    import Vue from 'vue'
    import VueRouter from 'vue-router'
    import VueResource from 'vue-resource'
    
    import App from './App'
    import Home from './components/Home'
    import 'bootstrap/dist/css/bootstrap.css'
    
    Vue.use(VueRouter)
    Vue.use(VueResource)
    
    const routes = [{
      path : '/',
      component : Home
    },{
      path : '/home',
      component : Home
    }];
    
    const router = new VueRouter({
      routes
    });
    
    /* eslint-disable no-new */
    // 实例化我们的 Vue
    var app = new Vue({
      el: '#app',
      router,
      ...App,
    });
    

    这有两个与 1.0 不同的地方

    一、vue-router路由的参数由对象统一变为了数组要注意。还有则是实例化 vue 的el参数已经不能设置htmlbody了,因为在vue2中是会替换我们指定的标签

    二、我们必须在实例化 vue 的时候指定渲染什么组件,以前我们是通过路由来指定如router.start(App, '#app'),而在 vue2 中则不需要了

    可以发现我们在main.js里使用了两个组件App.vueHome.vue,稍后让我们具体实现它们的内容。

    而我们的index.html只需要保留<div id="app"></div>即可,我们的 Vue 在实例化时设置了el : '#app' 所以会替换这标签,为我们App组件的内容

    //index.html
    <div id="app"></div>
    

    我们的初始化就到这结束了,接下来让我们开始创建组件。

    创建首页组件

    首先我们在 App.vue 里为我们的应用写个顶部导航。

    // src/App.vue
    
    <template>
      <div id="wrapper">
        <nav class="navbar navbar-default">
          <div class="container">
            <a class="navbar-brand" href="#">
              <i class="glyphicon glyphicon-time"></i>
              计划板
            </a>
            <ul class="nav navbar-nav">
              <li><router-link to="/home">首页</router-link></li>
              <li><router-link to="/time-entries">计划列表</router-link></li>
            </ul>
          </div>
        </nav>
        <div class="container">
          <div class="col-sm-3">
            
          </div>
          <div class="col-sm-9">
            <router-view></router-view>
          </div>
        </div>
      </div>
    </template>
    
    

    除了我们的navbar以外,我们还需要一个.container去放我们其余需要展示的信息。 并且在这里我们要放一个router-view标签,vue-router的切换就是通过这个标签开始显现的。

    在这有个与 1.0 不同的地方

    以前我们可以直接通过写 a 标签 然后写 v-link 属性进行路由跳转,在 vue2 中改为了写<router-link>标签再写对应属性( to )进行跳转

    接着,我们需要创建一个Home.vue作为我们的首页

    // src/components/Home.vue
    
    <template>
      <div class="jumbotron">
        <h1>任务追踪</h1>
        <p>
          <strong>
            <router-link to="/time-entries">创建一个任务</router-link>
          </strong>
        </p>
      </div>
    </template>
    

    不出意外的话,你可以看见如下效果

    创建侧边栏组件

    目前我们首页左侧还有一块空白,我们需要它放下一个侧边栏去统计所有计划的总时间。

    // src/App.vue
    
      //...
    
      <div class="container">
        <div class="col-sm-3">
          <sidebar></sidebar>
        </div>
        <div class="col-sm-9">
          <router-view></router-view>
        </div>
      </div>
    
      //...
    
    <script>
      import Sidebar from './components/Sidebar.vue'
    
      export default {
        components: { 'sidebar': Sidebar },
      }
    </script>
    

    Sidebar.vue我们需要通过 store 去获取总时间,我们的总时间是共享的数据

    // src/components/Sidebar.vue
    <template>
      <div class="panel panel-default">
        <div class="panel-heading">
          <h1 class="text-center">已有时长</h1>
        </div>
    
        <div class="panel-body">
          <h1 class="text-center">{{ time }} 小时</h1>
        </div>
    
      </div>
    </template>
    
    <script>
      export default {
        computed: {
            time() {
              return this.$store.state.totalTime
            }
          }
      }
    </script>
    

    创建计划列表组件

    然后我们需要去创建我们的时间跟踪列表。

    
    // src/components/TimeEntries.vue
    
    <template>
      <div>
        //`v-if`是 vue 的一个指令
        //`$route.path`是当前路由对象的路径,会被解析为绝对路径当
        //`$route.path !== '/time-entries/log-time'`为`true`是显示,`false`,为不显示。
        //to 路由跳转地址
        <router-link
          v-if="$route.path !== '/time-entries/log-time'"
          to="/time-entries/log-time"
          class="btn btn-primary">
          创建
        </router-link>
    
        <div v-if="$route.path === '/time-entries/log-time'">
          <h3>创建</h3>
        </div>
    
        <hr>
    
        <router-view></router-view>
    
        <div class="time-entries">
          <p v-if="!plans.length"><strong>还没有任何计划</strong></p>
    
          <div class="list-group">
          <--
            v-for 循环,注意参数顺序为(item,index) in items
          -->
            <a class="list-group-item" v-for="(plan,index) in plans">
              <div class="row">
                <div class="col-sm-2 user-details">
                
                <--
                `:src`属性,这个是 vue 的属性绑定简写`v-bind`可以缩写为`:`
                 比如 a 标签的`href`可以写为`:href`
                并且在 vue 的指令里就一定不要写插值表达式了(`:src={{xx}}`), vue 自己会去解析
                -->
                
                  <img :src="plan.avatar" class="avatar img-circle img-responsive" />
                  <p class="text-center">
                    <strong>
                      {{ plan.name }}
                    </strong>
                  </p>
                </div>
    
                <div class="col-sm-2 text-center time-block">
                  <h3 class="list-group-item-text total-time">
                    <i class="glyphicon glyphicon-time"></i>
                    {{ plan.totalTime }}
                  </h3>
                  <p class="label label-primary text-center">
                    <i class="glyphicon glyphicon-calendar"></i>
                    {{ plan.date }}
                  </p>
                </div>
    
                <div class="col-sm-7 comment-section">
                  <p>{{ plan.comment }}</p>
                </div>
    
                <div class="col-sm-1">
                  <button
                    class="btn btn-xs btn-danger delete-button"
                    @click="deletePlan(index)">
                  X
                  </button>
                </div>
    
              </div>
            </a>
    
          </div>
        </div>
      </div>
    </template>
    

    关于 template 的解释,都写在一起了,再看看我们的script

    // src/components/TimeEntries.vue
    
    <script>
        export default {
            name : 'TimeEntries',
            computed : {
              plans () {
                // 从 store 中取出数据
                return this.$store.state.list
              }
            },
            methods : {
              deletePlan(idx) {
                // 稍后再来说这里的方法
                // 减去总时间
                this.$store.dispatch('decTotalTime',this.plans[idx].totalTime)
                // 删除该计划
                this.$store.dispatch('deletePlan',idx)
              }
            }
        }
    </script>
    

    别忘了为我们的组件写上一些需要的样式

    // src/components/TimeEntries.vue
    
    <style>
      .avatar {
        height: 75px;
        margin: 0 auto;
        margin-top: 10px;
        margin-bottom: 10px;
      }
      .user-details {
        background-color: #f5f5f5;
        border-right: 1px solid #ddd;
        margin: -10px 0;
      }
      .time-block {
        padding: 10px;
      }
      .comment-section {
        padding: 20px;
      }
    </style>
    

    既然我们的数据是共享的,所以我们需要把数据存在store

    我们在 src 下创建个目录为store

    store下分别创建 4 个 js 文件actions.js,index.js,mutation-types.js,mutations.js

    看名字也就知道这 4 个分别是做啥用的了,建议大家多阅读阅读vuex的文档,多姿势多动手实践,慢慢的也就能理解了。

    // src/store/index.js
    import Vue from 'vue'
    import Vuex from 'vuex'
    
    Vue.use(Vuex);
    
    // 先写个假数据
    const state = {
      totalTime: 0,
      list: [{
        name : '二哲',
        avatar : 'https://sfault-avatar.b0.upaiyun.com/147/223/147223148-573297d0913c5_huge256',
        date : '2016-12-25',
        totalTime : '6',
        comment : '12 月 25 日完善,陪女朋友一起过圣诞节需要 6 个小时'
      }]
    };
    
    export default new Vuex.Store({
      state,
    })
    

    由于新增了页面和 store 在我们的入口 js 文件里配置下

    // src/main.js
    import store from './store'
    import TimeEntries from './components/TimeEntries.vue'
    //... 
    
    const routes = [{
      path : '/',
      component : Home
    },{
      path : '/home',
      component : Home
    },{
      path : '/time-entries',
      component : TimeEntries,
    }];
    
    var app = new Vue({
      el: '#app',
      router,
      store,
      ...App,
    });
    
    

    不出意外的话,你可以在/time-entries 路由下看见这样的页面

    通过vue-Devtools我们可以发现我们的 store 已经构造好了并且成功从 store 获取了数据

    创建任务组件

    这个比较简单我们直接给出代码

    // src/components/LogTime.vue
    
    <template>
      <div class="form-horizontal">
        <div class="form-group">
          <div class="col-sm-6">
            <label>日期</label>
            <input
              type="date"
              class="form-control"
              v-model="date"
              placeholder="Date"
            />
          </div>
          <div class="col-sm-6">
            <label>时间</label>
            <input
              type="number"
              class="form-control"
              v-model="totalTime"
              placeholder="Hours"
            />
          </div>
        </div>
        <div class="form-group">
          <div class="col-sm-12">
            <label>备注</label>
            <input
              type="text"
              class="form-control"
              v-model="comment"
              placeholder="Comment"
            />
          </div>
        </div>
        <button class="btn btn-primary" @click="save()">保存</button>
        <router-link to="/time-entries" class="btn btn-danger">取消</router-link>
        <hr>
      </div>
    </template>
    
    <script>
      export default {
            name : 'LogTime',
            data() {
                return {
                    date : '',
                    totalTime : '',
                    comment : ''
                }
            },
            methods:{
              save() {
                const plan = {
                  name : '二哲',
                  image : 'https://sfault-avatar.b0.upaiyun.com/888/223/888223038-5646dbc28d530_huge256',
                  date : this.date,
                  totalTime : this.totalTime,
                  comment : this.comment
                };
                this.$store.dispatch('savePlan', plan)
                this.$store.dispatch('addTotalTime', this.totalTime)
                this.$router.go(-1)
              }
            }
        }
    </script>
    
    

    这个组件很简单就 3 个 input 输入而已,然后就两个按钮,保存我们就把数据 push 进我们 store 的列表里

    LogTime属于我们TimeEntries组件的一个子路由,所以我们依旧需要配置下我们的路由,并且利用 webpack 让它懒加载,减少我们首屏加载的流量

    // src/main.js
    //...
    const routes = [{
      path : '/',
      component : Home
    },{
      path : '/home',
      component : Home
    },{
      path : '/time-entries',
      component : TimeEntries,
      children : [{
        path : 'log-time',
        // 懒加载
        component : resolve => require(['./components/LogTime.vue'],resolve),
      }]
    }];
    
    //...
    

    vuex 部分

    在 vue2.0 中废除了使用事件的方式进行通信,所以在小项目中我们可以使用 Event Bus ,其余最好都使用 vuex ,本文我们使用 Vuex 来实现数据通信

    相信你刚刚已经看见了我写了很多this.$store.dispatch('savePlan', plan) 类似这样的代码,我们再次统一说明。

    仔细思考一下,我们需要两个全局数据,一个为所有计划的总时间,一个是计划列表的数组。

    src/store/index.js 没啥太多可介绍的,其实就是传入我们的state,mutations,actions来初始化我们的 Store 。如果有需要的话我们还可能需要创建我们的getter在本例中就不用了。

    接着我们看mutation-types.js,既然想很明确了解数据,那就应该有什么样的操作看起,当然这也看个人口味哈

    // src/store/mutation-types.js
    
    // 增加总时间或者减少总时间
    export const ADD_TOTAL_TIME = 'ADD_TOTAL_TIME';
    export const DEC_TOTAL_TIME = 'DEC_TOTAL_TIME';
    
    // 新增和删除一条计划
    export const SAVE_PLAN = 'SAVE_PLAN';
    export const DELETE_PLAN = 'DELETE_PLAN';
    
    
    // src/store/mutations.js
    import * as types from './mutation-types'
    
    export default {
        // 增加总时间
      [types.ADD_TOTAL_TIME] (state, time) {
        state.totalTime = state.totalTime + time
      },
      // 减少总时间
      [types.DEC_TOTAL_TIME] (state, time) {
        state.totalTime = state.totalTime - time
      },
      // 新增计划
      [types.SAVE_PLAN] (state, plan) {
        // 设置默认值,未来我们可以做登入直接读取昵称和头像
        const avatar = 'https://sfault-avatar.b0.upaiyun.com/147/223/147223148-573297d0913c5_huge256';
        
        state.list.push(
          Object.assign({ name: '二哲', avatar: avatar }, plan)
        )
      },
      // 删除某计划
      [types.DELETE_PLAN] (state, idx) {
        state.list.splice(idx, 1);
      }
    };
    
    

    最后对应看我们的actions就很明白了

    // src/store/actions.js
    
    import * as types from './mutation-types'
    
    export default {
      addTotalTime({ commit }, time) {
        commit(types.ADD_TOTAL_TIME, time)
      },
      decTotalTime({ commit }, time) {
        commit(types.DEC_TOTAL_TIME, time)
      },
      savePlan({ commit }, plan) {
        commit(types.SAVE_PLAN, plan);
      },
      deletePlan({ commit }, plan) {
        commit(types.DELETE_PLAN, plan)
      }
    };
    
    

    我们的actions其实就是去触发事件和传入参数啦

    加了这三个文件后我们的 store 终于完整了,更新下我们的代码

    // src/store/index.js 完整代码
    
    import Vue from 'vue'
    import Vuex from 'vuex'
    import mutations from './mutations'
    import actions from './actions'
    
    Vue.use(Vuex);
    
    const state = {
      totalTime: 0,
      list: []
    };
    
    export default new Vuex.Store({
      state,
      mutations,
      actions
    })
    
    

    this.$store.dispatch('savePlan', plan)当执行了这样的方法就会调用actions.js里的savePlan方法,而savePlan又会触发 mutations里的 types.SAVE_PLAN 最后修改数据视图更新

    PS :在这有个技巧就是,在mutations里都是用大写下划线连接,而我们的actions里都用小写驼峰对应。

    个人理解这其实就是一个发布订阅的模式

    mutation-types 记录我们所有的事件名

    mutations 注册我们各种数据变化的方法

    actions 则可以编写异步的逻辑或者是一些逻辑,再去commit 我们的事件

    如果有getter 我们可以把一些需要处理返回的数据放在这即可,不进行业务操作

    最后别忘了在我们的main.js里使用我们的store

    // src/store/main.js
    
    import store from './store'
    // ...
    
    var app = new Vue({
      el: '#app',
      router,
      store,
      ...App,
    });
    

    开始体验下你自己的任务计划板吧!

    最后

    通过本文,我们可以学习到许多关于 vue 的特性。

    1.了解了 vue-cli 脚手架

    2.初步对 webpack 有了一些了解和认识

    3.如何用.vue 愉快的开发

    4.使用 vuex 进行组件通信

    5.路由(子路由)的应用

    6.使用 vue-devtools 观察我们的数据


    个人网站 : http://www.meckodo.com github 地址: https://github.com/MeCKodo/vue-tutorial

    Have a nice day

    14 条回复    2016-12-25 18:54:30 +08:00
    IamJ
        1
    IamJ  
       2016-11-29 13:05:56 +08:00
    官方已经不推荐用 vue-resource ,推荐的是 axios
    a3mao
        2
    a3mao  
       2016-11-29 13:08:03 +08:00
    这个怎么跟 angluarJS 一个样?
    k9982874
        3
    k9982874  
       2016-11-29 13:20:33 +08:00
    赞!
    lwjcjmx123
        4
    lwjcjmx123  
       2016-11-29 13:36:48 +08:00 via Android
    赞一个
    lwjcjmx123
        5
    lwjcjmx123  
       2016-11-29 13:38:48 +08:00 via Android
    有一个问题想请教一下, webpack 打包号的静态文件放到服务器根目录下能正常访问,但是放到二级目录下, router-view 就渲染不出来, js 文件都正常加载了,网页也不报错,请问有解决思路么?不是路径的问题
    NemoAlex
        6
    NemoAlex  
       2016-11-29 13:47:26 +08:00
    @lwjcjmx123 配置 Webpack config 中的 assetsPublicPath 和 assetsSubDirectory
    lwjcjmx123
        7
    lwjcjmx123  
       2016-11-29 14:45:25 +08:00 via Android
    @NemoAlex 我设置过了./ 没用
    kokdemo
        8
    kokdemo  
       2016-11-29 15:07:06 +08:00
    这篇文章之前感觉看过啊……
    kodo
        9
    kodo  
    OP
       2016-11-30 11:55:23 +08:00
    @kokdemo 恩,以前我写了 vue1.0 的版本,这次是 vue2.0 的
    SKull4
        10
    SKull4  
       2016-12-05 16:43:35 +08:00
    @kodo 看博客里面,哥们以前打电竞的?
    luckyning
        11
    luckyning  
       2016-12-05 20:14:03 +08:00
    @IamJ 官方推荐 axios 是在哪里看到的呢
    kodo
        14
    kodo  
    OP
       2016-12-25 18:54:30 +08:00
    @SKull4 是的哈, SC , SC2
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1069 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 27ms · UTC 19:16 · PVG 03:16 · LAX 11:16 · JFK 14:16
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.