一步一步学Vue(四)

时间:2024-07-10 00:03:56

接上篇。上篇中给出了代码框架,没有具体实现,这一篇会对上篇定义的几个组件进行分别介绍和完善:

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>
*/