组件,有些可以完全独立运行完全不依赖外部属性,比如层级较高的页面组件。但大多时候,组件还是需要使用方做一些定制操作,并可以在状态变化时通知给使用方,于是,一个组件最基本的API就是prop、event、slot,只要了解它们,那么再复杂的功能也能够做出来。
prop
定义了这个组件有哪些可配置的属性,可通过父组件传递进来。如果是对象类型,比如对象或数组,它的默认值必须从一个工厂函数获取。
格式如下:
// 子组件 my-component
<template>
<div>
<span v-for="name in columns" :key="name">{{name}}</span>
</div>
</template>
<script>
export default {
props: {
total: {
type: Number,
default: 0
},
show: {
type: Boolean,
default: true
},
data: {
type: Object, // 对象类型
default () {
return {}
}
},
columns: {
type: Array, // 对象类型
default () {
return []
}
},
value: {
type: [String, Number, Boolean], // 支持多种类型
default: false
},
}
}
</script>
很多情况下,组件的数据属性是动态的。通常,父组件通过接口拉取数据,然后再更新组件属性数据。如果不做些特殊处理,你会发现,当组件属性变化时,组件不会更新。
这时,需要用watch
监听组件属性,同时在组件内声明一个变量,当监听的属性发生变化时,同步修改该变量。
模板中,不要直接使用属性,而改为组件变量值。
props: {
show: {
type: Boolean,
default: true
}
},
data() {
return {
isVisible: true
};
},
watch: {
show: function(val) {
this.isVisible = val;
}
}
上面的例子比较简单,监听了一个简单类型属性。如果是对象类型,且该对象可能包含子对象,且属性发生变更就是内部子对象变化,那么,需要用到深度监听。
那么,改造一下props: data
的监听器。
watch: {
data: {
deep: true,
immediate: true,
handler: function(val) {
this.formData = { ...val };
}
}
},
这样看起来貌似完美了。但是,如果父组件定义了一个空对象属性数据,但真实值是复杂对象呢?
// 父组件
<template>
<div>
<my-component :data={data} />
</div>
</template>
<script>
export default {
data() {
return {
// 定义了一个空对象
data: { }
};
},
mounted() {
// 返回值包含对象
this.data = {list: [1,2,3], size: 3}
},
</script>
运行之后你会发现,哪怕对组件属性data
做了深度监听,但是,当数据发生变化时,不会触发watch
。
为什么呢?
很简单,Vue2.0用的是Object.defineProperties
监听数据变化,而此方法不能监听到对象新增或者删除操作。
解法也很简单,在初始化组件数据时,把可能用到的子对象都定义好。
export default {
data() {
return {
data: { list:[], size:0 }
};
},
然后再试试,OK了。
吐槽一下,相同功能,React不需要都这么大弯子。当组件属性变化,React会自动触发组件的
render
函数。这是因为Vue本身对组件更新渲染做了底层处理,而React把这些交给使用者,使用方可根据shouldComponentUpdate
做优化
$emit
函数这个比较简单,当组件状态发生变化或者完成某些操作后,需要通知父组件,调用$emit
函数。
// 子组件
export default {
methods: {
onSubmit() {
this.$emit("getList", this.formData);
}
}
}
// 父组件
<template>
<my-component @getList="getDataList" />
</template>
export default {
methods: {
getDataList(formData) {
// doing something
}
}
}
除了$emit
,还有另外两种方式(这两种方法的弊端是,无法在兄弟间通信):
ref
:给元素或组件注册引用信息;ref
引用// 子组件:my-component
export default {
data () {
return {
title: 'my component'
}
},
methods: {
sayHello () {
window.alert('Hello');
}
}
}
// 父组件
<template>
<my-component ref="myCom"></my-component>
</template>
<script>
export default {
mounted () {
const com = this.$refs.myCom;
console.log(com.title); // my component
com.sayHello(); // 弹窗
}
}
</script>
ref
最常见的就是表单引用,可以在父组件里面做一些表单验证,或者表单清理的工作。
// form是组件的ref
// mainForm是组件内表单的ref
this.$refs.form.$refs.mainForm.clearValidate();
$parent
和 $children
基于当前上下文访问父组件或全部子组件。
场景:使用element-ui
的抽屉组件时,'visible'值很重要。如果把它设置为组件内部变量,同时监听属性'visible',那么,当关闭抽屉时,必须通知父组件更新属性变量(打开对话框的行为,是父组件发起的)。如果不更新父组件状态,那么关闭之后再次点击按钮不会触发属性变化,那么自然watch
事件不会被触发。
// 子组件 my-drawer
<template>
<el-drawer title="修订记录" :visible.sync="isDrawerVisible" :before-close="handleClose">
</el-drawer>
</template>
export default {
props: {
visible: {
type: Boolean,
default: false
}
},
data() {
return {
isDrawerVisible: false
};
},
watch: {
visible: function(val) {
this.isDrawerVisible = val;
}
},
methods: {
handleClose() {
// 修改父组件变量值
this.$parent.visible = false;
},
}
// 父组件
<template>
<my-drawer :visible="visible" />
</template>
export default {
data() {
return {
visible: false
};
}
slot
用于分发组件的内容。这个官网文档讲解很清楚:https://cn.vuejs.org/v2/guide/components-slots.html
场景:比较多了。比如我们可能通过 slot
做顶层的统一页面布局:
<template>
<div>
<head-top></head-top>
<div class="container_wrap">
<slot></slot>
</div>
</div>
</template>
<script>
import headTop from '@/components/headTop'
export default {
name: 'layout',
components: {
headTop
}
}
这样,父级内定义的内容,就会出现在组件对应的 slot 里,没有写名字的,就是默认的 slot。
// 使用 layout
<template>
<layout>
<el-button icon="el-icon-plus" size="small" type="primary" @click="onAdd">新建</el-button>
</layout>
</template>
当需要多个插槽时,会用到具名 slot,比如:
// 子组件 my-button
<template>
<button>
<slot name="icon"></slot>
<slot></slot>
</button>
</template>
// 使用my-button
<my-button>
<i slot="icon" class="el-icon-link" />
按钮 1
</my-button>
掌握了 Vue.js 组件的这三个 API 后,剩下的便是逻辑设计。 在组件开发中,最难的应当是解耦组件的交互逻辑,抽象业务能力,尽量把复杂的逻辑分发到不同的子组件中,然后彼此建立联系。