一步一步学Vue(四)
2017-07-22 22:12 JerremyZhang 阅读(2873) 评论(7) 编辑 收藏 举报接上篇。上篇中给出了代码框架,没有具体实现,这一篇会对上篇定义的几个组件进行分别介绍和完善:
1、TodoContainer组件
TodoContainer组件,用来组织其它组件,这是react中推荐的方式,也是redux中高阶组件一般就是用来包装成容器组件用的,比如redux中的connect函数,返回的包装组件就是一个容器组件,它用来处理这样一种场景:加入有A、B两个组件,A组件中需要通过Ajax请求和后端进行交互;B组件也需要通过Ajax请求和后端交互,针对这种场景有如下代码:
//组件A定义 var CompA={ template:'<div>A 渲染 list</div>', data:function(){ return { list:[] } }, methods:{ getListA:function(){ $.ajax({ url:'xxx', dataType:'json', success:r=>this.list=r.data }) } } }; //组件B定义 var CompB={ template:'<div>B 渲染list</div>', data:function(){ return { list:[] } }, methods:{ getListB:function(){ $.ajax({ url:'xxx', dataType:'json', success:r=>this.list=r.data }) } } }
可以看出,A组件和B组件中都会存在Ajax访问重复代码,有重复代码就要提取出来;第一种方式,提取公共方法,使用mixin混入到两个组件中,所谓混入就是动态把方法注入到两个对象中;
第二种方法使用外部传入,这是react中推荐的方式,使用props传入;其实我们仔细分析我们的两个组件,都是为了渲染列表数据,至于是在组件外请求还是在组件内请求,它是不关注的,这样我们可以进一步考虑,把AB组件重构成只用来渲染数据的pure组件,数据由外部传入,而vue正好提供了这种props父传子的机制,把Ajax操作定义到父组件中(就是我们这里提到的容器组件),也起到了重复代码提取的作用,基于此请看我们的第二版代码:
//A组件 var CompA={ template:'<div>A</div>', props:['list'] }; //B组件 var CompB={ template:'<div>B</div>', props:['list'] } //容器组件 var Container={ template:` <comp-a :list="listA" ></comp-a> <comp-b :list="listB" ></comp-b> `, components:{ 'comp-a':CompA, 'comp-b':CompB }, methods:{ getListA:function(){ //TODO:A 逻辑 }, getListB:function(){ //TODO:B 逻辑 } } }
这样A、B组件变成了傻白甜组件,只是负责数据渲染,所有业务逻辑由容器组件处理;容器组件把A、B组件需要的数据通过props的方式传递给它们。
已经明白了容器组件的作用,那么我们来实现一下前几篇中todolist的容器组件吧,上篇已有基本结果,这里先出代码后解释:
/** * 容器组件 * 说明:容器组件包括三个字组件 */ var TodoContainer = { template: ` <div class="container"> <search-bar @onsearch="search($event)"></search-bar> <div class="row"> <todo-list :items="items" @onremove="remove($event)" @onedit="edit($event)"></todo-list> <todo-form :init-item="initItem" @onsave="save($event)" ></todo-form> </div> </div> `, data: function () { return { /** * Todolist数据列表 * 说明:通过props传入到Todolist组件中,让组件进行渲染 */ items: [], /** * TodoForm初始化数据 * 说明:由于TodoForm包括两种操作:新增和编辑;新增操作无需处理,编辑操作需要进行数据绑定,这里通过传入initItem属性进行编辑时数据的初始化 * 如果传入的值为空,说明为新增操作,由initItem参数的Id是否为空,来确认是更新保存还是新增保存 */ initItem: { title: '', desc: '', id: '' } } }, components: { 'search-bar': SearchBar,/**SearchBar组件注册 */ 'todo-form': TodoForm,/**TodoForm组件注册 */ 'todo-list': todoList/**TodoList组件注册 */ }, methods: { /** * 模拟保存数据方法 * 辅助方法 */ _mock_save: function (lst) { list = lst; }, /** * 根据id查询对象 * 辅助方法 */ findById: function (id) { return this.items.filter(v => v.id === id)[0] || {}; }, /** * 查询方法 * 由SearchBar组件触发 */ search: function ($e) { this.items = list.filter(v => v.title.indexOf($e) !== -1); }, /** * 保存方法 * 响应新增和更新操作,由TodoForm组件触发 */ save: function ($e) { //id存在则为编辑保存 if (this.initItem.id) { var o = this.findById($e.id); o.title = $e.title; o.desc = $e.desc; } else { this.items.push(new Todo($e.title, $e.desc)); } this.initItem = { id: '', title: '', desc: '' }; this._mock_save(this.items); }, /** * 删除方法 * 响应删除按钮操作 * 由TodoItem组件触发 */ remove: function ($e) { this.items = this.items.filter(v => v.id !== $e); this._mock_save(this.items); }, /** * 编辑按钮点击时,进行表单数据绑定 */ edit: function ($e) { this.initItem = this.findById($e); } } }
我们把所有业务逻辑也放在容器组件中处理,其它组件都是傻白甜,这样的好处是,其它组件容易重用,因为只是数据渲染,并不涉及业务操作,这种组件没有业务相关性,比如一个list组件我可以用它显示用户信息,当然也可以用它显示角色信息,根据传入的数据而变化。
对上述代码,需要简单解释一下的是,Vue中父子event传递是通过$emit和$on来实现的,但是写法和angular中有一些差异;在angular中我们一般这样写:
//事件发射 $scope.$emit("onxxx",data); //事件监听 $scope.$on("onxxx",function(e,data){ //TODO: })
但是在vue中$on是直接使用v-on:onxxx或@onxxx来写的,所以一般存在的是这样的代码:
<todo-list :items="items" @onremove="remove($event)" @onedit="edit($event)"></todo-list> <todo-form :init-item="initItem" @onsave="save($event)" ></todo-form>
其它代码中加入了很多注释,也比较简单,就不做过多解释了,有疑问可提交。
2、SearchBar组件
SearchBar组件比较简单,只是简单触发查询按钮,发射(触发)onsearch事件,然后TodoContainer组件中使用 @onsearch="search($event)" 进行监听。
/** * 搜索组件 */ var SearchBar = { template: ` <div class="row toolbar"> <div class="col-md-8"> keyword: <input type="text" v-model="keyword" /> <input type="button" @click="search()" value="search" class="btn btn-primary" /> </div> </div> `, data: function () { return { keyword: '' } }, methods: { search: function () { this.$emit('onsearch', this.keyword); } } }
3、TodoForm组件
TodoForm组件,是我们Todolist中的表单组件,编辑和新增公用,我们需要考虑的是,我们的初始化数据由外部传入,首先看第一版代码,考虑有什么坑?
/** * 表单组件 */ var TodoForm = { template: ` <div class="col-md-6"> <div class="form-inline"> <label for="title" class="control-label col-md-4">title:</label> <input type="hidden" v-bind:value="todo.id" /> <input type="text" v-model="todo.title" class="form-control col-md-8"> </div> <div class="form-inline"> <label for="desc" class="control-label col-md-4">desc</label> <input type="text" v-model="todo.desc" class="form-control col-md-8"> </div> <div class="form-inline"> <input type="button" value="OK" v-on:click="ok()" class="btn btn-primary offset-md-10" /> </div> </div> `, props: ['initItem'],
data: function { return {todo: this.initItem} }, methods: { ok: function () { this.$emit('onsave', this.todo); } } }
这段代码有什么问题呢?我们把传入的初始化参数给了我们的todo对象,这样导致的直接问题是:新增的时候没问题,但是编辑的时候无法绑定数据,原因是,编辑操作实际上就是修改外部传入的initItem对象,但是todo只在组件初始化的时候被赋值,其它时候是不响应initItem变化的,如何才能响应initItem变化,很明显是我们的computed属性,computed属性会响应其封装对象的变化;代码第二版修改如下:
/** * 表单组件 */ var TodoForm = { template: ` <div class="col-md-6"> <div class="form-inline"> <label for="title" class="control-label col-md-4">title:</label> <input type="hidden" v-bind:value="todo.id" /> <input type="text" v-model="todo.title" class="form-control col-md-8"> </div> <div class="form-inline"> <label for="desc" class="control-label col-md-4">desc</label> <input type="text" v-model="todo.desc" class="form-control col-md-8"> </div> <div class="form-inline"> <input type="button" value="OK" v-on:click="ok()" class="btn btn-primary offset-md-10" /> </div> </div> `, props: ['initItem'], computed: { todo: function () {
//这里不直接返回this.initItem 是因为会导致双向绑定,因为传递的是引用 return { id: this.initItem.id, title: this.initItem.title, desc: this.initItem.desc }; } }, methods: { ok: function () { this.$emit('onsave', this.todo); } } }
4、TodoList && TodoItem组件
TodoList组件是数据列表组件,它的每一个列表项我们进行了一次封装,每一个list中的列表项,就是一个TodoItem组件,所以在TodoItem组件中,只需要引入todoitem数据即可,唯一需要关注的就是todoItem组件中会触发onremove和onedit事件。
/** * 列表项组件 */ var TodoItem = { template: ` <tr> <th>{{todo.id}}</th> <td>{{todo.title}}</td> <td>{{todo.desc}}</td> <td> <input type="button" value="remove" @click="remove()" class="btn btn-danger" /> <input type="button" value="edit" @click="edit()" class="btn btn-info" /> </td> </tr> `, props: ['todo'], methods: { edit: function () { console.log(this.todo); this.$emit('onedit', this.todo.id); }, remove: function () { this.$emit('onremove', this.todo.id); } } } /** * 列表组件 */ var TodoList = { template: ` <div class="col-md-6"> <table class="table table-bordered"> <tr> <th></th> <th>title</th> <th>desc</th> <th></th> </tr> <todo-item v-for="item in items" :todo="item" :key="item.id" @onedit="edit($event)" @onremove="remove($event)"></todo-item> </table> </div> `, props: ['items'], components: { 'todo-item': TodoItem }, methods: { edit: function ($e) { this.$emit('onedit', $e); }, remove: function ($e) { this.$emit('onremove', $e); } } }
这两个数据渲染组件就没什么好说名的了;但是大家发现一个很不爽的问题:由于我们在容器中统一管理了业务逻辑(更逼格高一些,叫状态),所以在todoitem组件中触发的事件没办法直接到TodoContainer组件中,只能通过一级一级的往上传递,所以在todolist中也有和todoitem中类似的触发事件的代码this.$emit('onremove', $e);这里组件层级才2级,如果多了状态管理就是灾难了,幸好vuex的出现,就是专门处理这种问题的,后期用到vuex的时候会详细介绍。
5、小结
todolist这个demo,就暂时告一段落了,下一片会以一个稍微复杂的demo(信息管理)来介绍vue-router,当然在一步一步学习的过程中,我还是没能做到把所有基本概念过一遍,我个人觉得还是用到再解释吧,否则还不如直接看文档来的方便。。。
完整代码:
index.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta http-equiv="X-UA-Compatible" content="ie=edge"> <title>demo1</title> <script src="https://cdn.bootcss.com/vue/2.4.1/vue.js"></script> <link href="https://cdn.bootcss.com/bootstrap/4.0.0-alpha.6/css/bootstrap.css" rel="stylesheet"> </head> <body class="container"> <div id="app"> <todo-container></todo-container> </div> <script src="./todolist.js"></script> </body> </html>
todolist.js
; (function () { var list = []; var Todo = (function () { var id = 1; return function (title, desc) { this.title = title; this.desc = desc; this.id = id++; } })(); /** * 搜索组件 */ var SearchBar = { template: ` <div class="row toolbar"> <div class="col-md-8"> keyword: <input type="text" v-model="keyword" /> <input type="button" @click="search()" value="search" class="btn btn-primary" /> </div> </div> `, data: function () { return { keyword: '' } }, methods: { search: function () { this.$emit('onsearch', this.keyword); } } } /** * 表单组件 */ var TodoForm = { template: ` <div class="col-md-6"> <div class="form-inline"> <label for="title" class="control-label col-md-4">title:</label> <input type="hidden" v-bind:value="todo.id" /> <input type="text" v-model="todo.title" class="form-control col-md-8"> </div> <div class="form-inline"> <label for="desc" class="control-label col-md-4">desc</label> <input type="text" v-model="todo.desc" class="form-control col-md-8"> </div> <div class="form-inline"> <input type="button" value="OK" v-on:click="ok()" class="btn btn-primary offset-md-10" /> </div> </div> `, props: ['initItem'], computed: { todo: function () { return { id: this.initItem.id, title: this.initItem.title, desc: this.initItem.desc }; } }, methods: { ok: function () { this.$emit('onsave', this.todo); } } } /** * 列表项组件 */ var TodoItem = { template: ` <tr> <th>{{todo.id}}</th> <td>{{todo.title}}</td> <td>{{todo.desc}}</td> <td> <input type="button" value="remove" @click="remove()" class="btn btn-danger" /> <input type="button" value="edit" @click="edit()" class="btn btn-info" /> </td> </tr> `, props: ['todo'], methods: { edit: function () { console.log(this.todo); this.$emit('onedit', this.todo.id); }, remove: function () { this.$emit('onremove', this.todo.id); } } } /** * 列表组件 */ var TodoList = { template: ` <div class="col-md-6"> <table class="table table-bordered"> <tr> <th></th> <th>title</th> <th>desc</th> <th></th> </tr> <todo-item v-for="item in items" :todo="item" :key="item.id" @onedit="edit($event)" @onremove="remove($event)"></todo-item> </table> </div> `, props: ['items'], components: { 'todo-item': TodoItem }, methods: { edit: function ($e) { this.$emit('onedit', $e); }, remove: function ($e) { this.$emit('onremove', $e); } } } /** * 容器组件 * 说明:容器组件包括三个字组件 */ var TodoContainer = { template: ` <div class="container"> <search-bar @onsearch="search($event)"></search-bar> <div class="row"> <todo-list :items="items" @onremove="remove($event)" @onedit="edit($event)"></todo-list> <todo-form :init-item="initItem" @onsave="save($event)" ></todo-form> </div> </div> `, data: function () { return { /** * Todolist数据列表 * 说明:通过props传入到Todolist组件中,让组件进行渲染 */ items: [], /** * TodoForm初始化数据 * 说明:由于TodoForm包括两种操作:新增和编辑;新增操作无需处理,编辑操作需要进行数据绑定,这里通过传入initItem属性进行编辑时数据的初始化 * 如果传入的值为空,说明为新增操作,由initItem参数的Id是否为空,来确认是更新保存还是新增保存 */ initItem: { title: '', desc: '', id: '' } } }, components: { 'search-bar': SearchBar,/**SearchBar组件注册 */ 'todo-form': TodoForm,/**TodoForm组件注册 */ 'todo-list': TodoList/**TodoList组件注册 */ }, methods: { /** * 模拟保存数据方法 * 辅助方法 */ _mock_save: function (lst) { list = lst; }, /** * 根据id查询对象 * 辅助方法 */ findById: function (id) { return this.items.filter(v => v.id === id)[0] || {}; }, /** * 查询方法 * 由SearchBar组件触发 */ search: function ($e) { this.items = list.filter(v => v.title.indexOf($e) !== -1); }, /** * 保存方法 * 响应新增和更新操作,由TodoForm组件触发 */ save: function ($e) { //id存在则为编辑保存 if (this.initItem.id) { var o = this.findById($e.id); o.title = $e.title; o.desc = $e.desc; } else { this.items.push(new Todo($e.title, $e.desc)); } this.initItem = { id: '', title: '', desc: '' }; this._mock_save(this.items); }, /** * 删除方法 * 响应删除按钮操作 * 由TodoItem组件触发 */ remove: function ($e) { this.items = this.items.filter(v => v.id !== $e); this._mock_save(this.items); }, /** * 编辑按钮点击时,进行表单数据绑定 */ edit: function ($e) { this.initItem = this.findById($e); } } } var app = new Vue({ el: '#app', components: { 'todo-container': TodoContainer } }); })(); /** * * * <div id="app"> * <todo-container></todo-container> * </app> */