像AngularJS这种前端框架可以让我们非常方便地开发出强大的单页应用,然而有时候Angular这种大型框架对于我们的项目来说过于庞大,很多功能不一定会用到。这时候我们就需要评估一下使用它的必要性了。如果我们仅仅需要在一个简单的网页里添加屈指可数的几个功能,那么用Angular就太麻烦了,必要的安装、配置、编写路由和设计控制器等等工作显得过于繁琐。
这时候我们需要一个更加轻量级的解决方案。Vue.js就是一个不错的选择。Vue.js是一个专注于视图模型(ViewModal)的框架。视图模型是UI和数据模型之间进行数据交流的桥梁,实现了UI到数据模型之间的双向数据绑定。它不是一个“完整的框架”,而是一个专注于视图层的简单灵活的框架。
接下来我们将通过一个简单的备忘录应用来带大家了解Vue.js的基础知识。为了让大家更加关注Vue.js本身,我们设计一个基于本地数据的客户端应用,在本文最后会提及Vue.js与后端的交互方式。
准备工作
让我们先通过npm获取Vue.js和Bootstrap(非必须,这里是为了应用其样式库),在命令行中输入以下内容:
npm install vue bootstrap</div>
然后创建index.html和app.js两个文件:
touch index.html app.js</div>
同时添加以下内容到index.html中
<!-- index.html --><!doctype html><html><head> <meta charset="utf-8"> <title>Vue</title> <!-- CSS --> <link rel="stylesheet" href="node_modules/bootstrap/dist/css/bootstrap.min.css"></head><body> <!— 导航栏 --> <nav class="navbar navbar-default"> <div class="container-fluid"> <a class="navbar-brand"><i class="glyphicon glyphicon-bullhorn"></i> Vue 备忘录</a> </div> </nav> <!—应用的主要部分 --> <div class="container" id="events"> <!—添加一个表单 --> <div class="col-sm-6"> <div class="panel panel-default"> <div class="panel-heading"> <h3>Add an Event</h3> </div> <div class="panel-body"> </div> </div> </div> <!—展示备忘录的内容 --> <div class="col-sm-6"> <div class="list-group"> </div> </div> </div> <!-- JS --> <script src="node_modules/vue/dist/vue.js"></script> <script src="app.js"></script></body></html></div>
ID为”events”的<div>标签是这个应用的核心部分。之后我们会给这个核心部分创建一个Vue实例。
创建一个Vue实例
首先,让我们创建一个Vue实例并将这个实例的” el”属性设为”#events”。这样实例就会和ID为”events”的容器绑定,
// app.jsnew Vue({// 和ID为”events”的容器绑定 el: '#events'});</div>
到了这一步,Vue的功能就会在div#events 中生效了。在添加其他内容之前,让我们先给创建好的Vue实例添加一些必要的属性:
// app.js new Vue({ //和ID为”events”的容器绑定 el: '#events', // 在data属性中我们定义和网页交互的数据 data: {}, // 在应用加载的时候会执行ready属性中的函数 ready: function() {}, // 我们在应用中使用到的方法会在methods属性中定义 methods: {}});</div>
data属性是一个对象,声明了我们这个应用的视图模型中的所有数据
ready属性是一个函数,会在应用加载的时候被执行,通常在这里调用其他方法来初始化应用所需的数据
methods方法定义了在这个应用中需要使用的方法
添加内容到表单
我们需要在表单里输入备忘录的详细内容。我们用到了HTML5 的原生时间选择器来设置备忘录内容的时间。(注意这个功能在火狐浏览器中不适用,推荐用Chrome或Safari)
<div class="panel-body"> <div class="form-group"> <input class="form-control" placeholder="事件名称" v-model="event.name"> </div> <div class="form-group"> <textarea class="form-control" placeholder="事件描述" v-model="event.description"></textarea> </div> <div class="form-group"> <input type="date" class="form-control" placeholder="Date" v-model="event.date"> </div> <button class="btn btn-primary" @click="addEvent">提交</button></div></div>
我们给input标签和textarea标签添加了一个” v-model”指令。类似于Angular的”ng-model”,这个v-model的值规定了视图模型中绑定到这个标签的数据,这个数据不光在这里可以用,在容器中的其他地方也可用。
我们给提交按钮增加了一个” @click”指令,这个指令是简写,全称应该是” v-on:click”,作用是给这个按钮绑定了一个点击事件的监听器,当点击事件触发时,@click指令中的监听函数就会执行,在本例中我们给提交按钮绑定的是addEvent函数。我们还可以绑定其他事件,写法则是@事件名=”监听函数”,如我们想给keydown事件绑定一个监听函数f,可以这么写:@keydown=”f”或者v-on:keydown=”f”
到了这一步如果你预览一下网页你会看到如下内容:
添加数据
之前我们曾提到过addEvent方法,这个方法是用来添加新的备忘录数据的。
现在我们会定义这个方法并添加一些必要的数据
// app.js ... data: { event: { name: '', description: '', date: '' }, events: []},// 在应用加载的时候会执行ready属性中的函数ready: function() { // 在应用加载的时候我们需要初始化数据 this.fetchEvents();},// 我们在应用中使用到的方法会在methods属性中定义methods: { // 我们定义一个方法来获取数据 fetchEvents: function() { var events = [{ id: 1, name: '开会', description: '上午9点在21层大会议室', date: '2015-09-10' }, { id: 2, name: '购物', description: '买个充电宝', date: '2015-10-02' }, { id: 3, name: '学习', description: '学习Vue官网上的教程', date: '2016-03-11' } ];// $set 是Vue提供的一个向数组插入数据的方法,在执行它的时候还会刷新视图 this.$set('events', events); }, //向事项数组插入数据 addEvent: function() { if(this.event.name) { this.events.push(this.event); this.event = { name: '', description: '', date: '' }; } }}</div>
在data属性中,我们定义了一个event对象和一个events数组,分别表示事项和事项数组。这些数据在应用加载时会被加载。如果我们不预定义event对象的话,虽然后续功能可以实现,但是浏览器会报这个错:
它们的意思是指你在应用中使用的数据如果不在data属性中声明,那么应用的性能就会受到影响。因此我们在应用中使用到的数据最好都在data属性中声明。
在ready属性中我们定义了fetchEvents方法来获取数据,在该方法中我们通过 vm.$set方法来将数据添加到视图中,其功能类似于数组的push方法,同时它还会刷新视图,该方法的参数必须是一个字符串keypath,表示传入的数据。具体用法可以看 这里。
最后,在method属性中我们定义了addEvents方法,检查event.name的值是否存在,如果存在则添加event到events数组中。之后,event对象中的数据会被清空,同时表单也会随之被清空。
添加事项清单
我们用一个事项清单来列出所有事项:
<div class="list-group"> <a href="#" class="list-group-item" v-for="event in events"> <h4 class="list-group-item-heading"> <i class="glyphicon glyphicon-bullhorn"></i> {{ event.name }} </h4> <h5> <i class="glyphicon glyphicon-calendar" v-if="event.date"></i> {{ event.date }} </h5> <p class="list-group-item-text" v-if="event.description">{{ event.description }}</p> <button class="btn btn-xs btn-danger" @click="deleteEvent($index)">Delete</button> </a></div></div>
我们通过 v-for指令来 批量渲染DOM结构相同、显示内容不同的元素。在这个例子中,我们给一个a标签添加了v-for指令,它会遍历events数组中的数据,每一次遍历的数据我们用event来表示。添加了v-for指