# 移除 v-on.native 修饰符
非兼容

# 概览

v-on.native 修饰符已被移除。

# 2.x 语法

默认情况下,传递给带有 v-on 的组件的事件监听器只有通过 this.$emit 才能触发。要将原生 DOM 监听器添加到子组件的根元素中,可以使用 .native 修饰符:

<my-component
  v-on:close="handleComponentEvent"
  v-on:click.native="handleNativeClickEvent"
/>
1
2
3
4

# 3.x 语法

v-on.native 修饰符已被移除。同时,新增的 emits 选项允许子组件定义真正会被触发的事件。

因此,对于子组件中被定义为组件触发的所有事件监听器,Vue 现在将把它们作为原生事件监听器添加到子组件的根元素中 (除非在子组件的选项中设置了 inheritAttrs: false)。

<my-component
  v-on:close="handleComponentEvent"
  v-on:click="handleNativeClickEvent"
/>
1
2
3
4

MyComponent.vue

<script>
  export default {
    emits: ['close']
  }
</script>
1
2
3
4
5

# 迁移策略

  • 删除 .native 修饰符的所有实例。
  • 确保所有组件都使用 emits 选项记录其事件。

迁移构建标记:COMPILER_V_ON_NATIVE

# 参考