vue2.0 如何自定义组件(vue组件的封装)
一、前言
之前的博客聊过 vue2.0和react的技术选型;聊过vue的axios封装和vuex使用。今天简单聊聊 vue 组件的封装。
vue 的ui框架现在是很多的,但是鉴于移动设备的复杂性,兼容性问题突出。像 Mint-UI 等说实话已经很不错了,但是坑也是不少,而且项目中很多功能仅凭这些也实现不了,这需要我们去封装自己的可复用组件。
二、封装组件的步骤
1. 建立组件的模板,先把架子搭起来,写写样式,考虑好组件的基本逻辑。 os:思考1小时,码码10分钟,程序猿的准则。
2. 准备好组件的数据输入。即分析好逻辑,定好 props 里面的数据、类型。(后面详解)
3. 准备好组件的数据输出。即根据组件逻辑,做好要暴露出来的方法。(后面详解)
4. 封装完毕了,直接调用即可。
接下来以一个很简单的例子具体说明一下
现在先看一下demo的效果图
三、代码详解
1. 先说一下 props
我们在父组件中需要将子组件需要的数据导入,用法如下:
<search @selectFunc="selectFunc" :searchList="searchList" :selectValue="selectValue"></search>
:searchList="searchList" 就是我们的数据,这个可以写多个。这里我传输了2个参数过去,主要是做数据修改的说明。大家可以先忽略。
在子组件中,我们的接收和使用方法如下:
props: {
searchList: Array,
selectValue: Object
},
mounted() {
this.data = this.searchList
},
我们在 props 中接收数据,注意props对象里面 键值 是对改数据的 数据类型 的规定。做了规范,使用者就只能传输指定类型的数据,否则报警告
而props对象中的数据,我们可以直接在当前组件中使用 this.searchList,可以直接使用。这里要强调一下,props传过来的数据只做展示,不得修改,想修改,再新写一个data中的变量承接做数据的再处理。至于原因,同上,可以看一下js的原型。至于原理嘛,不懂的可以取脑补一下 js的原型 。 os:这些基础,在这就不做详述了。
以上就是props传递过来的数据的使用了。
2. emit的使用(如何暴露组件方法)
我们已经会使用 父组件向子组件传数据了,那如子组件如何来修改父组件的数据呢?
这里提供 2 种实现方法,但是 第一种不推荐,强烈不推荐
方式一:
selectValue: {
data: '1'
},
。。。。。。。。。。。。。。。
this.selectValue.data = '我被修改了'
即,父组件将 对象 数据传递给子组件,子组件直接修改props过来的对象的值
可以实现,感觉是一个比较快捷的方式。但是不推荐,这种方式写多了,容易出错,特别是多层组件嵌套的时候。这种修改对代码的迭代和错误的捕捉都不友好,所以建议大家别这样写。
他的实现原理简单提一下: 这个对象、数组啦,是引用数据类型,说白了,就是存储单元的信息是指针,真正数据在别的地方,通过指针查询的数据,所以这样写,对浏览器来说仅仅是传递了一个指针,数据还是同一份数据。所以你能修改。
方式二:
正儿八经的通过 $emit 方法去掉父组件的方法,在父组件中修改data的数据。(根正苗红的方法,规范写法)
// 子组件
this.$emit('selectFunc', value)
// 父组件
<search @selectFunc="selectFunc" :searchList="searchList" :selectValue="selectValue"></search>
selectFunc(value) {
this.selectValue2 = value
console.log(this.selectValue)
console.log(this.selectValue2)
}
将父组件的方法注入子组件 @selectFunc="selectFunc" ,然后在子组件中通过 $emit 调用他,并传递参数。达到修改的目的。
四、 demo代码
父组件:
<template>
<section class="f-mainPage">
<!--selectFunc 选择完成的回调 searchList 下拉列表的数据-->
<search @selectFunc="selectFunc" :searchList="searchList" :selectValue="selectValue"></search>
</section>
</template>
<script type="text/ecmascript-6">
import Search from '../vuePlugin/search'
export default {
data() {
return {
searchList: ['草船借箭', '大富翁', '测试数据'],
// 直接通过props传递对象 修改,挺便捷的,但是不规范
selectValue: {
data: '1'
},
// 通过emit修改,规范写法
selectValue2: ''
}
},
mounted() {},
methods: {
pageGo(path) {
this.$router.push('/' + path)
},
selectFunc(value) {
this.selectValue2 = value
console.log(this.selectValue)
console.log(this.selectValue2)
}
},
components: {
Search
}
}
</script>
<style lang="scss" scoped>
.f-mainPage{
width: 100%;
.g-banner{
width: 100%;
background-image: url(../../../static/main_bg.png);
background-repeat: no-repeat;
background-size: 100% 100%;
position: relative;
overflow: hidden;
color: white;
text-align: center;
p:nth-child(1) {
margin: 10px auto 0px auto;
font-size: 1.3rem;
}
.f-banscri {
margin: 15px auto 8px auto;
font-size: 0.95rem;
}
.f-moneyMax{
margin: 5px auto 0px auto;
font-size: 2.4rem;
}
.f-returnCash{
width: 120px;
height: 35px;
text-align: center;
line-height: 35px;
background-color: white;
color: #169BD5;
display: inline-block;
border-radius: 5px;
font-size: 1rem;
margin-top: 35px;
position: relative;
.f-mmmbd{
position: absolute;
width: 100%;
height: 100%;
background-color: transparent;
top: 0;
left: 0;
}
}
}
.g-cashInfor{
width: 100%;
text-align: center;
display: flex;
justify-content: space-between;
div{
width: 50%;
height: 60px;
line-height: 60px;
box-sizing: border-box;
}
div:nth-child(1){
border-bottom: 1px solid #878787;
border-right: 1px solid #878787;
}
div:nth-child(2){
border-bottom: 1px solid #878787;
}
}
.g-operate{
width: 100%;
height: auto;
overflow: hidden;
ul{
list-style: none;
padding: 0;
margin: 0;
font-size: 1.05rem;
li{
height: 60px;
line-height: 60px;
padding-left: 25px;
position: relative;
span{
width: 20px;
height: 20px;
position: absolute;
top: 20px;
right: 20px;
background-image: url(../../../static/go.png);
background-repeat: no-repeat;
background-size: 100% 100%;
}
}
}
.f-goodNews{
width: 340px;
height: 144.5px;
margin: 20px auto 30px auto;
text-align: center;
background-image: url(../../../static/banner.png);
background-repeat: no-repeat;
background-size: 100% 100%;
}
}
}
</style>
子组件:
<template>
<div class="searchZJ">
<div class="f-search">
<div class="f-searchIn" v-bind:class="{searchInFous: this.fousFlag}">{{this.searchValue}}<span v-bind:class="{searchActive: this.searchFlag}" v-on:click="searchDown"></span></div>
<div class="f-searchXl" v-if="this.dataHas" v-bind:style="{height:this.searchFous, border:this.searchBorder}">
<div v-for="item in searchList" v-on:click="choseValue(item)">{{item}}</div>
</div>
<div class="f-searchXl" v-else >
<div>暂无数据</div>
</div>
</div>
</div>
</template>
<script type="text/ecmascript-6">
export default {
data() {
return {
data: [],
dataHas: true,
searchFlag: false,
searchFous: '0',
fousFlag: false,
searchValue: '',
searchBorder: 'none'
}
},
props: {
searchList: Array,
selectValue: Object
},
mounted() {
this.data = this.searchList
},
methods: {
searchDown() {
this.searchFlag === false ? this.searchFlag = true : this.searchFlag = false
this.searchFous === '0' ? this.searchFous = 'auto' : this.searchFous = '0'
this.searchBorder === 'none' ? this.searchBorder = '1px solid #D9D9D9' : this.searchBorder = 'none'
this.fousFlag === false ? this.fousFlag = true : this.fousFlag = false
},
choseValue(value) {
this.searchValue = value
this.searchDown()
this.selectValue.data = '我被修改了'
this.$emit('selectFunc', value)
}
}
}
</script>
<style scoped lang="stylus" rel="stylesheet/stylus">
.f-search{
width: 250px;
height: auto;
position: relative;
margin-left: 20px;
box-sizing: border-box;
}
.f-searchIn{
width: 250px;
height: 35px;
line-height: 35px;
font-size: 0.95rem;
border-radius: 5px;
overflow: hidden;
position: relative;
background-color: white;
box-shadow: none;
box-sizing: border-box;
color: #000000;
padding-left: 10px;
border: 1px solid #A3A3A3;
}
.searchInFous{
border: 1px solid #57C4F6;
box-shadow: 0px 0px 5px #57C4F6;
}
.f-searchIn > span{
display: block;
width: 28px;
height: 28px;
background-image: url(../../../static/upDown.png);
background-size: 100% 100%;
background-repeat: no-repeat;
background-position: 0px -13px;
position: absolute;
top: 10px;
right: 5px;
}
.f-searchIn .searchActive{
background-position: 0px 12px;
top: -2px;
}
.f-search .f-searchXl{
position: absolute;
width: 100%;
height: auto;
max-height: 220px;
top: 41px;
left: -1px;
border-radius: 5px;
/*border: 1px solid #D9D9D9;*/
background-color: white;
overflow-x: hidden;
overflow-y: scroll;
}
.f-search .f-searchXl > div{
height: 35px;
line-height: 38px;
color: #000000;
padding-left: 25px;
font-size: 0.92rem;
}
.f-search .f-searchXl > div:hover{
background-color: #D5F1FD;
}
</style>
五、 总结
这里主要是总结一下vue组件封装的思路,帮大家梳理一下。很简单,和jQuery插件、react组件一样,所有组件都是一个套路,就是 函数思想。
组件就是台做烤肠的机器,我放进去猪肉,再按一下各种开关,然后你给我烤肠。
1. 定义好 你需要使用者传入的数据
2. 定义好 你提供给使用者的方法
3. 写好组件的内部逻辑
这就OK了,一个完美的,可复用的组件就完成了。 os: 在此吐槽一下,那些自认为是优秀的组件,其实,别人拿着是没法用的。 o(╥﹏╥)o
os: 愿大家工作过程中能规范编程习惯,一起为前端代码大社区做贡献。
注:
os: 2018/06/06
鉴于一些朋友的评论,我在这再做一些解答哈,这个言论往深了去不保证准确性,我尽量吧。有问题的地方还是希望大家及时指出。
1. 父子组件通信的方式,远不止我说的那两种。但是,通过 $emit 的方式是根正苗红的,不带任何差错的,是封装优秀组件最好的方式()
(1) 通过ref 通信
父组件设置ref,通过$refs对象来获取子组件的数据
<search ref="refTest3" ></search>
.......
console.log(this.$refs.refTest3)
console.log(this.$refs.refTest3.selectValue.data)
其实,很简单。ref 就是直接获取了你的dom节点,如果是div一类的基本dom和js的document.getElementsByTagName()效果一样的,而且这样节省开销。你可以在父组件中直接 this.$refs.refTest3.selectValue.data。直接获取子组件data中的数据,或者别的数据都可以获取。但是,这个不是我们封装组件会用的东西,因为这个用在父组件。组件的思想是 独立的。所以,大家平时用用就好了,如果要封装可复用的组件,这个还是不实用的。 os:可能他有特殊用法是我不清楚的,如果有请大家分享
(2)通过 vuex 通信
vuex 大家都知道,变量统一管理(方便的很),╮(╯▽╰)╭ 但是用这个来封装组件的完全就是抬杠了。vuex、redux等等这些都是针对组件多层传输数据不便,而做的状态统一管理,说白了是针对大家都要用的数据才会放到vuex中,而组件思想,是封装一个独立的、可复用的功能模块。这根本就是2个理念。希望大家不要被误导。
(3).aync 父子组件数据双向绑定
说实话,这也是来抬杠的。说白了,双向绑定不还是 通过 $emit 监听数据更新事件,来调用父组件的方法吗?
这里简单说一下这个数据双向绑定的,还是很常用的方法。不啰嗦,看代码:
<search @selectFunc="selectFunc" :syncTest.sync="syncTest"></search>
.........
this.$emit('update:syncTest', value)
其实,很简单。在父组件向子组件props数据的时候,加一个 .sync 修饰符,然后在子组件显示的调用 emit 来修改他。 说白了就是添加这样的一个事件绑定 @update:foo="val => bar = val">
上述的方法就是 父子组件数据双向绑定。子组件实时修改 props 的方法。
欢迎大家提出别的问题和建议