zoukankan      html  css  js  c++  java
  • 借助 Vue 来构建单页面应用

    (1/2)Vue构建单页应用最佳实战

    前言

    我们将会选择使用一些vue周边的库

    1.使用node.js后台,了解到如何获取数据

    2.实现单页路由

    3.实现HTTP请求我们的node

    4.单项数据流

    5.使用.vue文件进行开发

    最终我们将会构建出一个小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-time-tracker cd vue-time-tracker npm i

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

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

    这些都准备好后,我们需要为我们的路由和XHR请求下载两个库,我们可以从vue的官网中找到他们。

    npm i vue-resource vue-router --save

    初始化(main.js)

    查看我们的应用文件,我们可以在src目录下找到 App.vue 和 main.js 。在 main.js 文件中,我们引入 Vue 和 App ,并且创建了一个vue的实例(因为在router这行引入了App组件 router.start(App, '#app') )

    // src/main.js
    
    import Vue from 'vue'
    import App from './App.vue'
    import Hello from './components/Hello.vue'
    
    import VueRouter from 'vue-router'
    import VueResource from 'vue-resource'
    
    //注册两个插件
    Vue.use(VueResource)
    Vue.use(VueRouter)
    
    const router = new VueRouter()
    
    // 路由map
    router.map({
      '/hello': {
        component: Hello
      }
    })
    
    router.redirect({
      '*': '/hello'
    })
    
    router.start(App, '#app')

    我们还需要在 index.html 包裹下我们的 <app></app>

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

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

    创建首页 View

    首先,我们需要为我们的应用增加下bootstrap.css,为了方便,在这就直接在头部引入CDN。

    <head>
      <meta charset="utf-8">
      <title>计划板</title>
      <link href="//cdn.bootcss.com/bootstrap/3.3.6/css/bootstrap.min.css" rel="stylesheet">
    </head>

    接着在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><a v-link="'/home'">首页</a></li>
              <li><a v-link="'/time-entries'">计划列表</a></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 的切换就是通过这个标签开始显现的。

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

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

    既然我们需要显示Home,那就需要开始配置路由,这很简单,只需要在 main.js 里把 Hello.vue 换为 Home.vue 即可

    //...
    router.map({
      '/Home': {
        component: Home
      }
    })
    
    router.redirect({
      '*': '/Home'
    })

    创建 任务列表 View

    在这个页面,我们需要去创建我们的时间跟踪列表。

    PS:现在这个页面没有数据,之后我们会在后台配置

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

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

    // src/components/TimeEntries.vue
    
    <script>
      export default {
        data () {
          // 事先模拟一个数据
          let existingEntry = {
            user: {
              name: '二哲',
              email: 'kodo@forchange.cn',
              image: 'https://sfault-avatar.b0.upaiyun.com/888/223/888223038-5646dbc28d530_huge256'
            },
            comment: '我的一个备注',
            totalTime: 1.5,
            date: '2016-05-01'
          }
    
          return {
            timeEntries: [existingEntry]
          }
        },
        methods: {
          deleteTimeEntry (timeEntry) {
            //这个方法用于删除某一项计划
            let index = this.timeEntries.indexOf(timeEntry)
            if (window.confirm('确定要删除吗?')) {
              this.timeEntries.splice(index, 1)
              //这里会派发到父组件上,执行父组件events里的deleteTime方法
              this.$dispatch('deleteTime', timeEntry)
            }
          }
        },
        events: {
          timeUpdate (timeEntry) {
            this.timeEntries.push(timeEntry)
            //继续向上派发
            return true
          }
        }
      }
    </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>

    由于新增了页面,所以我们继续配置我们的路由

    // src/main.js
    
    import TimeEntries from './components/TimeEntries.vue'
    
    //...
    
    router.map({
      '/home': {
        component: Home
      },
      '/time-entries': {
        component: TimeEntries
      }
    })
    
    //...

    创建任务组件

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

    // 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="timeEntry.date"
              placeholder="Date"
            />
          </div>
          <div class="col-sm-6">
            <label>时间</label>
            <input
              type="number"
              class="form-control"
              v-model="timeEntry.totalTime"
              placeholder="Hours"
            />
          </div>
        </div>
        <div class="form-group">
          <div class="col-sm-12">
            <label>备注</label>
            <input
              type="text"
              class="form-control"
              v-model="timeEntry.comment"
              placeholder="Comment"
            />
          </div>
        </div>
        <button class="btn btn-primary" @click="save()">保存</button>
        <button v-link="'/time-entries'" class="btn btn-danger">取消</button>
        <hr>
      </div>
    
    </template>
    
    <script>
      export default {
        data () {
          return {
            //模拟一个默认值
            timeEntry: {
              user: {
                name: '二哲',
                email: 'kodo@forchange.cn',
                image: 'https://sfault-avatar.b0.upaiyun.com/888/223/888223038-5646dbc28d530_huge256'
              }
            }
          }
        },
        methods: {
          save () {
              let timeEntry = this.timeEntry
              this.$dispatch('timeUpdate', timeEntry)
              this.timeEntry = {}
            }
        }
      }
    </script>

    这个组件很简单就3个input输入而已,然后就两个按钮,保存我们就把数据push进我们的列表里,并且初始化我们的timeEntry。取消的话,我们就路由定位到 /time-entries 即可。

    ps:按理来说我们应该是要填写6个数据包括名字,邮箱和头像。但这里为了演示就暂时先这样。以后结合后台我们会继续完善这里。

    LogTime 属于我们 TimeEntries 组件的一个子路由,所以我们依旧需要配置下我们的 router.map

    // src/main.js
    
    import LogTime from './components/LogTime.vue'
    
    //...
    
    router.map({
      '/home': {
        component: Home
      },
      '/time-entries': {
        component: TimeEntries,
        subRoutes: {
          '/log-time': {
            component: LogTime
          }
        }
      }
    })
    
    //...

    创建侧边栏组件

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

    // src/App.vue
    
      //...
    
      <div class="container">
        <div class="col-sm-3">
          <sidebar :time="totalTime"></sidebar>
        </div>
        <div class="col-sm-9">
          <router-view></router-view>
        </div>
      </div>
    
      //...

    由于我们把总时间存放在最上级的父组件上,所以我们需要把我们的总时间传入我们的 sidebar 组件。

    在写下我们的两个时间计算方法

    <script>
      import Sidebar from './components/Sidebar.vue'
    
      export default {
        components: { 'sidebar': Sidebar },
        data () {
          return {
            totalTime: 1.5
          }
        },
        events: {
          timeUpdate (timeEntry) {
            this.totalTime += parseFloat(timeEntry.totalTime)
          },
          deleteTime (timeEntry) {
            this.totalTime -= parseFloat(timeEntry.totalTime)
          }
        }
      }
    </script>

    最后给出我们 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 {
        props: ['time']
      }
    </script>

    props 就是vue中传值的写法,不仅要在我们自定义的标签上传入 <sidebar :time="totalTime"></sidebar> ,还需要在组件里js里定义 props: ['time']

    最后

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

    1.了解了vue-cli脚手架

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

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

    4.父子组件通信

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

    下一章,我们将会结合node学习vue-resource,更好的完善我们SPA应用

    番外篇

    我看很多人都不知道如何引入bootstrap,我就在这加了一下

    首先npm i jquery bootstrap style-loader --save-dev;

    然后我修改了两个文件 第一个是 webpack.base.conf.js 我把module都改了

    最后我们在入口js文件里加三行代码

    import 'jquery' import 'bootstrap/dist/css/bootstrap.css' import 'bootstrap/dist/js/bootstrap'

    在npm run dev 看看页面吧! 在head里会有一个style全是bootstrap的代码.别忘了把index.html里的第三方bootstrap注释了.

    在我这次更新的代码里,我已经把引用第三方代码删了.

    (2/2)Vue构建单页应用最佳实战

    前言

    本章节,将会把所有的请求全写为跨域请求。不知道为什么,很多人一用了框架就会不知所措。给大家一个忠告,享受框架带来的便利,别忘了时刻提醒自己学好基础知识。

    先把一些不必要的代码删了。

    //TimeEntries.vue 的模拟数据代码
    data () {
      // 模拟下初始化数据
      /*let existingEntry = {
        comment: '我的第一个任务',
        totalTime: 1.5,
        date: '2016-05-01'
      }*/
      return {
        timeEntries: []
      }
    },
    //头像和昵称暂时写死
    <div class="col-sm-2 user-details">
      <img src="https://avatars1.githubusercontent.com/u/10184444?v=3&s=460" class="avatar img-circle img-responsive" />
      <p class="text-center">
        <strong>
          二哲
        </strong>
      </p>
    </div>
    
    
    //LogTime.vue里的模拟数据代码
    data () {
        return {
          timeEntry: {
            /*user: {
              name: '二哲',
              email: 'kodo@forchange.cn',
              image: 'https://sfault-avatar.b0.upaiyun.com/888/223/888223038-5646dbc28d530_huge256'
            },*/
          }
        }
    },

    我们将专注3个字段的增删改查,任务时间,持续时间,备注。

    正文

    我们的数据交互其实很简单,所以我在这选择使用大家最熟悉的 express 和 mongodb ,在一个 app.js 文件里完成所有的 controller 。

    首先,安装几个必要的包 npm i express mongodb morgan body-parser --save-dev;

    简单解释下Morgan和body-parser,其实就是一个log美化和解析参数。具体大家可以google下。

    在我们的根目录下,创建 app.js 初始化以下代码

    //app.js
    var express = require('express');
    var app = express();
    var bodyParser = require('body-parser');
    var morgan = require('morgan');
    
    var MongoClient = require('mongodb').MongoClient;
    var mongoUrl = 'mongodb://localhost:27017/mission';
    var _db;
    
    app.use(morgan('dev'));
    app.use(bodyParser.json());
    app.use(express.static('dist'));
    
    MongoClient.connect(mongoUrl, function (err, db) {
      if(err) {
        console.error(err);
        return;
      }
    
      console.log('connected to mongo');
      _db = db;
      app.listen(8888, function () {
        console.log('server is running...');
      });
    });

    解释下mongoUrl这行 mongodb://localhost:27017/mission 连接相应的端口,并且使用mission表。此时你是没有 mission 数据库的,这不用在意。在我们后续操作中,它将会自动创建一个mission数据库。

    上面代码的意思是,我们创建我们的一个mongo连接,当数据库连接上了后再启动我们的服务器。

    接着先启动我们的mongo服务。在命令行里 sudo mongo 。

    如果你用得是webstrom编辑器,可以直接运行 app.js ,如果是命令行,那就使用 node app.js

    如果看见命令行输出了 connected to mongo server is running... 就可以在 8888 端口访问我们的应用了。(在这之前别忘了build你的代码)

    由于我们讲得是跨域,所以我们讲在我们的dev环境下完成所有的请求。 npm run dev

    关闭我们的8888端口页面,进入8080端口的开发环境。

    写下我们第一个创建任务的请求。

    //app.js
    
    //使用post方法
    app.post('/create', function(req, res, next) {
        //接收前端发送的字段
      var mission = req.body;
      //选择一个表my_mission 此时没有没关系,也会自动创建
      var collection = _db.collection('my_mission');
        //如果我们需要的字段不存在,返回前端信息
      if(!mission.comment || !mission.totalTime || !mission.date) {
        res.send({errcode:-1,errmsg:"params missed"});
        return;
      }
        //如果存在就插入数据库,返回OK
      collection.insert({comment: mission.comment, totalTime: mission.totalTime,date:mission.date}, function (err, ret) {
        if(err) {
          console.error(err);
          res.status(500).end();
        } else {
          res.send({errcode:0,errmsg:"ok"});
        }
      });
    });

    修改下我们的 LogTime.vue

    //LogTime.vue
    <button class="btn btn-primary" @click="save()">保存</button>
    
    methods: {
        save () {
          this.$http.post('http://localhost:8888/create',{
            comment : this.timeEntry.comment,
            totalTime : this.timeEntry.totalTime,
            date : this.timeEntry.date
          }).then(function(ret) {
            console.log(ret);
            let timeEntry = this.timeEntry
            console.log(timeEntry);
            this.$dispatch('timeUpdate', timeEntry)
            this.timeEntry = {}
          })
        }
    }

    输入好内容,点击保存按钮,会发现报了个错。这其实就是最常见的跨域请求错误。

    但是我们明明写得是 post 请求为什么显示得是 options 呢?

    这其实是跨域请求前会先发起的一个 options 请求,需要先问问服务端,我需要一些操作可以吗?如果服务端那里是允许的,才会继续让你发送 post 请求。

    我不知道那些使用 vue-resource 各种姿势也想满足跨域请求的人是怎么想的。想上天吗?

    所以我们需要服务端配置,而不是前端。

    //app.js
    app.all("*", function (req, res, next) {
      res.header('Access-Control-Allow-Origin', '*');
      res.header("Access-Control-Allow-Headers", "Content-Type,Content-Length, Authorization, Accept,X-Requested-With");
      res.header("Access-Control-Allow-Methods","PUT,POST,GET,DELETE,OPTIONS");
      if (req.method == 'OPTIONS') {
        res.send(200);
      } else {
        next();
      }
    });

    Access-Control-Allow-Origin 是设置你的来源域名,写 * 是很危险的操作。所以我们可以直接写成我们所需的域名和端口,别人就没法请求了。

    另外几行就不解释了,一看就懂。

    不出意外,可以发现发送了options后,马上发送了post,然后就创建成功了。看下mongo的表,也多了一条记录。

    接着来让我们一口气写完剩下的三个请求。列表渲染,删除计划,获取总时长。

    //app.js
    var ObjectID = require('mongodb').ObjectID
    
    //获取总时长
    app.get('/time', function(req, res, next) {
        //获取数据表
      var collection = _db.collection('my_mission');
      var time = 0;
      //查询出所有计划
      collection.find({}).toArray(function (err, ret) {
        if(err) {
          console.error(err);
          return;
        }
        //所有计划累加时长
        ret.forEach(function (item, index) {
          time += +item.totalTime;
        });
        //返回时长
        res.json({errcode:0,errmsg:"ok",time:time});
      });
    });
    
    //获取列表
    app.get('/time-entries', function(req, res, next) {
      var collection = _db.collection('my_mission');
      collection.find({}).toArray(function (err, ret) {
        if(err) {
          console.error(err);
          return;
        }
        res.json(ret);
      });
    });
    
    //删除计划
    app.delete('/delete/:id', function (req, res, next) {
      var _id = req.params.id;
      var collection = _db.collection('my_mission');
      console.log(_id)
      //使用mongodb的唯一ObjectId字段查找出对应id删除记录
      collection.remove({_id: new ObjectID(_id)} ,function (err, result) {
        if(err) {
          console.error(err);
          res.status(500).end();
        } else {
          res.send({errcode:0,errmsg:"ok"});
        }
      });
    });

    前端部分

    //App.vue
    ready() {
        this.$http.get('http://localhost:8888/time')
          .then(function(ret) {
            this.totalTime = ret.data.time;
          })
          .then(function(err) {
            console.log(err);
          })
    },
    //TimeEntries.vue
    route : {
      data(){
        this.$http.get('http://localhost:8888/time-entries')
          .then(function(ret) {
            this.timeEntries = ret.data;
          })
          .then(function(err) {
            console.log(err);
          })
      }
    },
    //TimeEntries.vue
    <div class="col-sm-1">
      <button
        class="btn btn-xs btn-danger delete-button"
        @click="deleteTimeEntry(timeEntry)">
        X
      </button>
    </div>
    
    deleteTimeEntry (timeEntry) {
        // 删除
        let index = this.timeEntries.indexOf(timeEntry)
        let _id = this.timeEntries[index]._id
        if (window.confirm('确认删除?')) {
          this.$http.delete('http://localhost:8888/delete/' + _id)
            .then(function(ret) {
              console.log(ret);
            })
            .then(function(err) {
              console.log(err)
            });
          this.timeEntries.splice(index, 1)
          this.$dispatch('deleteTime', timeEntry)
        }
    }

    完结

    到此,我们就将我们整个应用完成了。新增创建删除都可用了。

    本来还想有上传头像等,那样觉得更多的是偏后端教学。既然我们是vue的简单入门教程就不过多介绍。

    本系列让大家轻松的了解学习了vue,vue-router,vue-resource,express,mongodb的运用。

    还是那句话,享受框架带来便利的同时,别忘了加强基础的训练。基本功才是真正的王道啊。玩电竞的玩家一定深有体会。

    最后给有兴趣的同学留下两个简单的作业 1.完成头像昵称的字段 2.完成修改操作

    源码地址: https://github.com/MeCKodo/vue-tutorial

    以小白的视角记录问题,如果你有什么不懂的,欢迎来讨论。
  • 相关阅读:
    数学函数,字符串函数,聚合函数
    javascript大神修炼记(7)——OOP思想(多态)
    Join的表顺序
    java web 基础
    LVS入门
    Eclipse 一直提示 loading descriptor for 的解决方法
    nginx的配置总结
    nginx入门(安装,启动,关闭,信号量控制)
    如何正大光明的使用 google 进行搜索
    npm报错Error: ENOENT, stat 'D:NodeLearn ode-global'
  • 原文地址:https://www.cnblogs.com/cindy79/p/7071993.html
Copyright © 2011-2022 走看看