defineEmits 属性:用于创建自定义事件,接收子组件传递过来的数据。
注意:如果自定义事件的名称,和原生事件的名称一样,那么只会触发自定义事件。
defineEmits 仅适用于 setup 语法糖,其它写法请见:《Vue3 子传父 组件传参 emit》
语法格式:
// 子组件:创建自定义事件,传递数据 const emit = defineEmits(['自定义事件']); emit('自定义事件', 数据1, 数据2); // 父组件:绑定自定义事件,接收数据 <组件标签 @自定义事件="函数名"></组件标签> const 函数名 = (参数1, 参数2) => { console.log(参数1, 参数2); }
基础使用
一、子组件:创建自定义事件,传递数据。
<template> <h3>我是子组件</h3> </template> <script setup> import { ref } from "vue"; let name = ref("张三"); // 创建 myEvent 自定义事件 const emit = defineEmits(['myEvent']); // 使用 myEvent 自定义事件,传递数据 emit('myEvent', name.value, 999); </script>
二、父组件:给组件标签绑定自定义事件,接收数据。
<template> <h3>我是父组件</h3> <p>{{ title }}</p> <hr /> <!-- 绑定 myEvent 自定义事件 --> <Child @myEvent="add"></Child> </template> <script setup> import Child from '../components/Child'; import { ref } from 'vue'; let title = ref(); // 创建事件函数,接收数据 const add = (name, num) => { title.value = name; console.log('我是父组件', name, num); } </script>
注:子组件使用自定义事件后,父组件中的事件函数会自动执行。