《Vue.js实战》章七 组件——标签页组件:思路详解
先上带有部分注释的全部代码
<!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>Document</title>
<script src="Vue.2.6.10.js"></script>
</head>
<body>
<!-- 需求分析:
1.每个标签页的主体内容(即html结构、文本、图片等)应当是由使用组件的父级控制的,这部分可以作为一个slot,
slot的数量决定了标签切换按钮的数量。点击每个按钮时,另外的标签对应的slot应该被隐藏掉。第一种想法,在slot里写三个div,再
根据需要隐藏和显示。更好的办法应该是让组件帮忙处理这部分逻辑,我们只需要聚焦slot内容本身。这种情况下,再定义一个子组件pane,
嵌套在标签页组件tabs里,把业务代码放在pane的slot内,然后各个pane都作为整个tabs的组件。
tabs和pane两个组件是分离的,但tabs上的标题应该由pane组件来定义,又因为slot写在pane里,所以应该在组件初始化(或标签标题动态改变)时,tabs从
当前的pane里获取标题并保存起来。-->
<div id="app" v-cloak>
<tabs v-model="activeKey">
<pane label="标签一" name="1">
标签一内容
</pane>
<pane label="标签二" name="2">
标签二内容
</pane>
<pane label="标签三" name="3">
标签三内容
</pane>
</tabs>
</div>
<script>
Vue.component('pane',{
name:"pane",
template:'\
<div class="pane" v-show="show">\
<slot></slot>\
</div>',
data() {
return {
show:true//pane需要控制标签页内容的显示与隐藏,配合v-show
//点击到这个pane对应的标签页按钮时,这个pane的show值才设置为true
//既然这样的话就应该有唯一标识的值来标识这个pane,可以设置一个prop:name让用户来设置,但不是必必需的,默认从0开始
//这一步操作由pane执行,pane本身并不知道自己是第几个。
//还有prop:label,tabs组件需要将它显示在标签栏标题中
}
},
props:{
name:{
type:String
},
label:{
type:String,
default:''
}
},//prop:label是用户可以动态调整的,所以在pane初始化、label更新时都需要通知父组件也更新,
//可以直接通过this.$parent来访问tabs组件的实例来调用它的方法更新标题
methods: {
updateNav(){
this.$parent.updateNav();//调用tabs的方法updateNav
}
},
watch: {
label(){
this.updateNav();
}
},
mounted() {
this.updateNav();//在pane初始化时调用一遍tabs的方法updateNav,同时监听prop:label,在其更新时也调用
},
})
Vue.component('tabs',{
template:'\
<div class="tabs">\
<div class="tabs-bar">\
<!--标签页的标题,需要使用v-for-->\
<div \
:class="tabCls(item)"\
v-for="(item,index) in navList"\
@click="handleChange(index)">\
{{ item.label }}\
</div>\
</div>\
<div class="tabs-content">\
<!--这里的slot即是嵌套的pane组件-->\
<slot></slot>\
</div>\
</div>',
props:{
value:{
type:[String,Number]
}
},
data() {
return {
//由于不能修改value于是自己复制一份维护
currentValue:this.value,
//用于渲染tabs的标题
navList:[]
}
},
methods:{
tabCls:function(item){
return [
'tabs-tab',
{
//给当前选中的div加一个class
'tabs-tab-active':item.name === this.currentValue
}
]
},
//点击tab标题时触发
handleChange:function(index){
var nav = this.navList[index];
var name = nav.name;
//改变当前选中的tab,并触发下面的watch
this.currentValue = name;
//更新value
this.$emit('input',name);
//触发一个自定义事件供父级使用
this.$emit('on-click',name);
},
getTabs(){
//通过遍历子组件得到所有panes组件
return this.$children.filter(function(item){
return item.$options.name === 'pane'
})
},
updateNav(){
this.navList = [];
//设置对this的引用,在function回调里this指向的并不是Vue实例
var _this = this;
this.getTabs().forEach(function(pane,index){
_this.navList.push({
label:pane.label,
name:pane.name || index
});
//如果没有给pane设置name就默认设置为索引
if(!pane.name){
pane.name = index;
}//设置当前选中的tabs的索引
if(index === 0){
if(!_this.currentValue){
_this.currentValue = pane.name || index;
}
}
});
this.updateStatus();
},
updateStatus(){
var tabs = this.getTabs();
//再次遍历pane组件,不过这是为了将当前选中的
//tab对应的pane组件内容显示出来,并将没有选中的隐藏掉
//在上一步中可能需要我们来设置currentValue来标识当前选中项的name(只有在用户没有设置value时才会自动设置)
var _this = this;
//显示当前选中的tab对应的pane组件,隐藏没有选中的
tabs.forEach(function(tab){
return tab.show = tab.name === _this.currentValue;
// return tab.show = (tab.name === _this.currentValue);
})
}
},
watch:{
value:function(val){
this.currentValue = val;
},
currentValue:function(){
//在当前选中的tabs发生变化时更新pane显示状态
this.updateStatus();
}
}
});
var app = new Vue({
el:"#app",
data:{
activeKey:'1'
}
});
</script>
</body>
</html>
先来明确思路:
务必明确插槽slot的作用与组件渲染方式。
以下为pane组件(建议将每一点结合起来看)
1.name:'pane',这里的name此时不是为了在组件内部递归调用自身,而是作为唯一标识,既可以专门设置一个prop:name,也可以不做设置在后面用index代替
2.show:true,由pane配合v-show以及name控制标签页的显示与隐藏,注意这一步操作是由tabs组件来进行的。
3.props的传入过滤,用户是可以动态调整prop:label的!因此如果在pane初始化或label更新时都需要通知父组件更新状态(即导航栏)
4.子组件的updateNav实际上是调用了父组件的这个同名方法
5.同4,watch与mounted中的updateNav方法也是调用父组件,作用域亦在父组件。
以下为tabs组件,分析并不从上到下。
6.先来看上面的updateNav()方法到底做了什么?
先将tabs的子组件列表navList初始化,然后调用getTabs()方法,得到所有的pane组件,注意filter、$options。
然后将组件的label值与name推入数组,如果我们没有给出name(如下图),那么就以索引值作为name。
在遍历过程中,遍历到第一个组件时,才会触发if(index === 0){...},此时这里的index是作为参数传入的索引值(无论有无指定name),
如果没有指定currentValue,那么此时将currentValue指定为这个pane的name或索引值。
再结束前还会触发一次updateStatus方法,见下文。
7.currentValue是什么??首先,我们知道这个变量存储着当前显示的标签页,上一点的操作实际上就是确保在初始化时有一个默认标签页显示。其他暂且不管。
.
8.先来看看模板中的这些是什么意思:
首先得明确v-for在这里会生成navList中的各个pane组件,并为每一个div填充这些数据。
tabCls的返回值是一个字符串数组,必定包含tabs-tab,如果这个标签页当前是被选中的,那么tabs的currentValue值即等于当前标签页的name,还会多获得一个active的类名。
9.当点击这个标签时,触发handleChange函数,并传入当前这个标签的index值,在这个函数里会完成以下操作:
1.先将当前标签以及name属性存储起来(nav,name)
2.将tabs组件的currentValue修改为name值
3.触发父组件的input事件与on-click自定义事件,
我们都知道v-model的本质是一个语法糖,activeKey的值会被动态修改为name值。(activeKey存在于tabs的data中,这一修改是双向的,便于进行其他操作)。
10.
updateStatus()方法,实际上是负责控制标签页显示与隐藏的方法。
再次遍历获取pane组件,并将结果再次遍历(注意,两次遍历分别的对象),如果tab.name === _this.currentValue,就可以露脸,否则隐藏。
这一步中实际依据是否设置value有不同的处理结果,有可能只规定了value的类型而没有规定default,currentValue为null。
注意!可能会都感到疑惑这个value的值在哪?
事实上value值就是那个activeKey,还记得v-model这个语法糖吗?
注意v-bind:value=“dataA”这一行!!!!
紧接着由于没有指定value,currentValue会被自动设置(第六点),为1(因为本例中有给prop指定name,否则就是第一个索引值0)。
如果指定了value值(本例value值即为activeKey),即指定要求初始化时被选中的标签页,那么pane初始化时,currentValue被指定为value值(以3为例),在tabs的updateNav()方法中,不会执行if(index === 0){...}中的改变,紧接着执行updateStatus(),name为3的pane组件会被显示出来。
12.假定一个完整的执行流程:
初始activeKey=2——v-model=2——value=2——cV=2——初始化,updateNav()——填充navList——执行updateStatus,将第二个组件显示出来。
点击第一个标签页——触发handleChange,改变cV值,更新value——tabs中的watch监控到value与cV值变化,将cV值修改为value值,同时再次执行updateStatus,更改显示状态。