Vue 3 中 defineEmits

在 Vue 3 中，`defineEmits` 是一个工具函数，它用于静态地声明组件的事件（或称为自定义事件）和它们的参数类型。在组件选项的 `setup()` 或者旧版本的 `methods`、`data` 等里使用，它可以帮助开发者更精确地指定组件可以发出哪些事件，以及这些事件接受什么样的参数。

当你在 `setup()` 函数中使用 `defineEmits`，它会返回一个对象，你可以像操作普通对象那样定义并使用事件发射器（emitter）。这样做的好处有两点：

1. **类型安全**：通过声明，Vue 可以在编译期间检查你是否正确地使用了事件名称和参数类型，避免在运行时因为错误的事件名或参数导致的意外行为。

2. **文档生成**：对于大型项目，这样的声明也有助于诸如 VuePress 这样的文档生成工具，自动生成关于组件API的清晰文档。

示例：

import { defineEmits } from 'vue';

export default {
  setup() {
    const emit = defineEmits<{
      // 定义了两个事件：一个是更新计数，另一个是加载更多
      updateCounter(num: number): void,
      loadMore(): void
    }>();

    // 使用 emit 来触发事件，例如：
    emit('updateCounter', 42);
    emit('loadMore');
    
    return { emit };
  }
};