在Vue还未流行的时候,我们都是用JQuery来封装一个选项卡插件,如今Vue当道,让我们一起来看看从JQ时代过来的前端是如何转换思路,用数据驱动DOM的思想打造一个Vue选项卡组件。
接下来,正文从这开始~
先来看一下用Vue写的选项卡组件在浏览器上的展示效果:
其实,你在浏览器上看到的UI界面效果也就是那么回事,中规中矩。当点开Chrome的Devtools下面的Elements选项,你看到的dom节点其实和jQuery的dom节点如出一辙,不同的是,现在你看到的dom树是在Vue组件生命周期mounted之后渲染得到的真实DOM
首先我们来聊一聊关于选项卡组件的业务需求,每个标签页的主体内容是由使用组件的父级控制,所以这部分应该是一个slot。slot的数量决定了标签切换按钮的数量。假设我们有3个标签页,点击每个标签按钮时,另外的两个标签对应的slot将被隐藏掉。
先来贴出html结构:
1 <div id="app" v-cloak>
2 <tabs>
3 <pane label="标签一" name="1">
4 <p>标签一的内容</p>
5 </pane>
6 <pane label="标签二" name="2">
7 <p>标签二的内容</p>
8 </pane>
9 <pane label="标签三" name="3">
10 <p>标签三的内容</p>
11 </pane>
12 </tabs>
13 </div>
由html结构可知,我们需要定义两个组件tabs和子组件pane,pane嵌套在标签组件tabs里面。由于tabs和pane两个组件是分离的,但是tabs的组件上的标题应该由pane组件来定义,因为slot是写在pane里,因此在组件初始化(以及标签标题动态改变)时,tabs要从pane里获取标题,并保存起来,自己使用。
接下来,先初始化各个组件:
Vue.component('tabs',{
template:`
<div class="tabs">
<div class="tabs-bar">
<!-- 标签页标题,这里要用v-for -->
</div>
<div class="tabs-content">
<!-- 这里的slot就是嵌套的pane -->
<slot></slot>
</div>
</div>
`
})
Vue.component('pane',{
name:'pane',
template:`
<div class="pane" v-show="show">
<slot></slot>
</div>
`,
data:function(){
return {
show:true
}
}
})
pane组件中需要控制标签页内容的显示与隐藏,所以设置一个data:show,并且用v-show指令来控制元素。
如果你是用jQuery写过选项卡,应该知道,在写完控制tabs标题显示与隐藏后,接下来该控制tabs内容的显示与隐藏了。那么如果要点击对应的标签页标题显示对应的标签页内容,此时应该有一个唯一的值来标识这个pane,我们可以设置一个prop:name让用户来设置,其实这个name也就是索引index。除了name,还需要设置标签页的标题prop:label。
props:{
name:{
type:String
},
label:{
type:String,
default:''
}
}
上面的标题prop:label 用户是可以动态调整的,所以在pane初始化及label更新时,都要通知父组件也更新,因为是独立独立组件,我们可以直接通过this.$parent访问tabs组件的实例来调用它的方法更新标题,这个方法名暂定为updateNav:
methods:{
updateNav(){
this.$parent.updateNav();
}
},
watch:{
label(){
this.updateNav();
}
},
mounted(){
this.updateNav();
}
通过以上代码可以看到,在生命周期mounted,也就是pane初始化时,调用一遍tabs的updateNav方法,同时监听了prop:label,在label更新时,同样调用。
说完了pane组件,剩下的任务就是完成tabs组件。
首先就是需要把pane组件设置的标题动态渲染出来,也就是当pane触发tabs的updateNav方法时,更新标题内容。
Vue.component('tabs',{
template:`
<div class="tabs">
<div class="tabs-bar">
<div
:class="tabCls(item)"
v-for="(item,index) in navList"
@click="handleChange(index)">
{{item.label}}
</div>
</div>
<div class="tabs-content">
<slot></slot>
</div>
</div>
`,
props:{
// 这里的value是为了可以使用v-model
value:{
type:[String, Number]
}
},
data:function(){
return {
// 因为不能修改value,所以复制一份自己维护
currentValue:this.value,
navList:[] // 用于渲染tabs的标题
}
},
methods:{
tabCls:function(item){
return [
'tabs-tab',
{
// 给当前选中的tab加一个class
'tabs-tab-active': item.name === this.currentValue
}
]
},
getTabs(){
// 通过遍历子组件,得到所有的pane组件
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设置那么,默认设置它的索引
if(!pane.name) pane.name = index;
// 设置当前选中的tab的索引
if(index === 0){
if(!_this.currentValue){
_this.currentValue = pane.name || index;
}
}
});
// console.log(this.navList);
this.updateStatus();
},
updateStatus(){
var tabs = this.getTabs();
// console.log(tabs);
var _this = this;
// 显示当前选中的tab对应的pane组件,隐藏没有选中的
tabs.forEach(function(tab){
// console.log(tab.name === _this.currentValue);
return tab.show = tab.name === _this.currentValue;
})
},
// 点击tab标题时触发
handleChange:function(index){
var nav = this.navList[index];
var name = nav.name;
console.log(name);
// 改变当前选中的tab,并触发下面的watch
this.currentValue = name;
}
},
watch:{
value:function(val){
this.currentValue = val;
},
currentValue:function(){
this.updateStatus();
}
}
})
getTabs是一个公用的方法,使用this.$children来拿到所有的pane组件实例。在遍历了每一个pane组件后,把他的label和name提取出来,构建成一个Object并添加到数据navList数组里。拿到navList后,就可以用v-for把tab的标题渲染出来,并且判断每个tab当前的状态。
通过以上代码,大家可以看到,在使用v-for指令循环显示tab标题时,使用v-bind:class指向了一个名为tabCls的methods来动态设置class名称。
点击每个tab标题时,会触发handleChange方法来改变当前选中的tab的索引,也就是pane组件的name。在watch选项里,我们监听了currentValue,当其发生变化时,触发了updateStatus方法来更新了pane组件的显示状态。
后记总结一下:该选项卡组件,使用了组件嵌套的方式,将一系列pane组件作为tabs组件的slot;tabs组件和pane组件通信上,使用了$parent 和 $children 的方法访问父链和子链;定义了prop:value 和 data: currentValue。
以上就是Vue标签页组件的所有实现过程。