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>

注：子组件使用自定义事件后，父组件中的事件函数会自动执行。

最终效果：

原创作者：吴小糖

创作时间：2024.1.10