按键修饰符

breaking

概览

以下是变更的简要总结：

  • BREAKING：不再支持使用数字 (即键码) 作为 v-on 修饰符
  • BREAKING：不再支持 config.keyCodes

2.x 语法

在 Vue 2 中，支持 keyCodes 作为修改 v-on 方法的方法。

  1. <!-- 键码版本 -->
  2. <input v-on:keyup.13="submit" />
  4. <!-- 别名版本 -->
  5. <input v-on:keyup.enter="submit" />

此外，你可以通过全局 config.keyCodes 选项。

  1. Vue.config.keyCodes = {
  2.   f1: 112
  3. }
  1. <!-- 键码版本 -->
  2. <input v-on:keyup.112="showHelpText" />
  4. <!-- 自定别名版本 -->
  5. <input v-on:keyup.f1="showHelpText" />

3.x 语法

从KeyboardEvent.keyCode has been deprecated 按键修饰符 - 图1 (opens new window) 开始，Vue 3 继续支持这一点就不再有意义了。因此，现在建议对任何要用作修饰符的键使用 kebab-cased (短横线) 大小写名称。

  1. <!-- Vue 3 在 v-on 上使用 按键修饰符 -->
  2. <input v-on:keyup.delete="confirmDelete" />

因此，这意味着 config.keyCodes 现在也已弃用，不再受支持。

迁移策略

对于那些在代码库中使用 keyCode 的用户，我们建议将它们转换为它们的 kebab-cased (短横线) 命名对齐。