事件 API

breaking

概览

$on$off$once 实例方法已被移除,应用实例不再实现事件触发接口。

2.x 语法

在 2.x 中,Vue 实例可用于触发通过事件触发 API 强制附加的处理程序 ($on$off$once),这用于创建 event hub,以创建在整个应用程序中使用的全局事件侦听器:

  1. // eventHub.js
  2. const eventHub = new Vue()
  3. export default eventHub
  1. // ChildComponent.vue
  2. import eventHub from './eventHub'
  3. export default {
  4. mounted() {
  5. // 添加 eventHub listener
  6. eventHub.$on('custom-event', () => {
  7. console.log('Custom event triggered!')
  8. })
  9. },
  10. beforeDestroy() {
  11. // 移除 eventHub listener
  12. eventHub.$off('custom-event')
  13. }
  14. }
  1. // ParentComponent.vue
  2. import eventHub from './eventHub'
  3. export default {
  4. methods: {
  5. callGlobalCustomEvent() {
  6. eventHub.$emit('custom-event') // 如果ChildComponent mounted,控制台中将显示一条消息
  7. }
  8. }
  9. }

3.x 更新

我们整个从实例中移除了 $on$off$once 方法,$emit 仍然是现有 API 的一部分,因为它用于触发由父组件以声明方式附加的事件处理程序

迁移策略

例如,可以通过使用实现事件发射器接口的外部库来替换现有的 event hub mitt 事件 API - 图1 (opens new window)

在兼容性构建中也可以支持这些方法。