[TOC]
文章是全部采用的 这种组合式API写法。
相对于选项式来说,组合式API这种写法更加自由。具体可以参考Vue文档对两种方式的描述
将介绍如下七种组件通信方式:
- props
- emit
- v-model
- refs
- provide/inject
- $attrs
- eventBus
- vuex/pinia(状态管理工具)
Props属性传值
Props方式是Vue中最常见的一种父传子的一种方式。将数据以及对数据的操作定义在父组件,子组件仅做列表的一个渲染;
子组件只需要对父组件传递的值进行渲染<template> <!-- 子组件 --> <child-components :list="list"></child-components> <!-- 父组件 --> <div class="child-wrap input-group"> <input v-model="value" type="text" class="form-control" placeholder="请输入" /> <div class="input-group-append"> <button @click="handleAdd" class="btn btn-primary" type="button"> 添加 </button> </div> </div> </template> <script setup> import { ref } from 'vue' import ChildComponents from './child.vue' const list = ref(['JavaScript', 'HTML', 'CSS']) const value = ref('') // add 触发后的事件处理函数 const handleAdd = () => { list.value.push(value.value) value.value = '' } </script>
<template> <ul class="parent list-group"> <li class="list-group-item" v-for="i in props.list" :key="i">{{ i }}</li> </ul> </template> <script setup> // import { defineProps } from 'vue' const props = defineProps({ list: { type: Array, default: () => [], }, }) </script>
emit发送事件
emit方式也是Vue中最常见的组件通信方式,该方式用于子传父
将列表定义在父组件,子组件只需要传递添加的值
在子组件中点击【添加】按钮后,emit一个自定义事件,并将添加的值作为参数传递。<template> <div class="child-wrap input-group"> <input v-model="value" type="text" class="form-control" placeholder="请输入" /> <div class="input-group-append"> <button @click="handleSubmit" class="btn btn-primary" type="button"> 添加 </button> </div> </div> </template> <script setup> import { ref, defineEmits } from 'vue' const value = ref('') const emits = defineEmits(['add']) const handleSubmit = () => { emits('add', value.value) value.value = '' } </script>
在父组件中只需要监听子组件自定义的事件,然后执行对应的添加操作。<template> <!-- 父组件 --> <ul class="parent list-group"> <li class="list-group-item" v-for="i in list" :key="i">{{ i }}</li> </ul> <!-- 子组件 --> <child-components @add="handleAdd"></child-components> </template> <script setup> import { ref } from 'vue' import ChildComponents from './child.vue' const list = ref(['JavaScript', 'HTML', 'CSS']) // add 触发后的事件处理函数 const handleAdd = value => { list.value.push(value) } </script>
v-model
v-model是Vue中一个比较出色的语法糖,就比如下面这段代码
是下面这段代码的简写形势<ChildComponent v-model:title="pageTitle" />
v-model确实简便了不少<ChildComponent :title="pageTitle" @update:title="pageTitle = $event" />
在子组件中我们首先定义props和emits,然后添加完成之后emit指定事件。<template> <div class="child-wrap input-group"> <input v-model="value" type="text" class="form-control" placeholder="请输入" /> <div class="input-group-append"> <button @click="handleAdd" class="btn btn-primary" type="button"> 添加 </button> </div> </div> </template> <script setup> import { ref, defineEmits, defineProps } from 'vue' const value = ref('') const props = defineProps({ list: { type: Array, default: () => [], }, }) const emits = defineEmits(['update:list']) // 添加操作 const handleAdd = () => { const arr = props.list arr.push(value.value) emits('update:list', arr) value.value = '' } </script>
注:update:是Vue中的固定写法,表示props中的某个属性名。
父组件中使用就比较简单
<template>
<!-- 父组件 -->
<ul class="parent list-group">
<li class="list-group-item" v-for="i in list" :key="i">{{ i }}</li>
</ul>
<!-- 子组件 -->
<child-components v-model:list="list"></child-components>
</template>
<script setup>
import { ref } from 'vue'
import ChildComponents from './child.vue'
const list = ref(['JavaScript', 'HTML', 'CSS'])
</script>
refs
在使用选项式API时,我们可以通过this.$refs.name的方式获取指定元素或者组件,但是组合式API中就无法使用哪种方式获取。如果我们想要通过ref的方式获取组件或者元素,需要定义一个同名的Ref对象,在组件挂载后就可以访问了。
<template>
<ul class="parent list-group">
<li class="list-group-item" v-for="i in childRefs?.list" :key="i">
{{ i }}
</li>
</ul>
<!-- 子组件 ref的值与<script>中的保持一致 -->
<child-components ref="childRefs"></child-components>
<!-- 父组件 -->
</template>
<script setup>
import { ref } from 'vue'
import ChildComponents from './child.vue'
const childRefs = ref(null)
</script>
<template>
<div class="child-wrap input-group">
<input
v-model="value"
type="text"
class="form-control"
placeholder="请输入"
/>
<div class="input-group-append">
<button @click="handleAdd" class="btn btn-primary" type="button">
添加
</button>
</div>
</div>
</template>
<script setup>
import { ref, defineExpose } from 'vue'
const list = ref(['JavaScript', 'HTML', 'CSS'])
const value = ref('')
// add 触发后的事件处理函数
const handleAdd = () => {
list.value.push(value.value)
value.value = ''
}
defineExpose({ list })
</script>
setup组件默认是关闭的,也即通过模板ref获取到的组件的公开实例,不会暴露任何在