2.5: v-on modifiers

Author: yyx990803

src/v2/guide/events.md

@@ -243,7 +243,21 @@ You can also [define custom key modifier aliases](../api/#keyCodes) via the glob
 Vue.config.keyCodes.f1 = 112
 ```
 
-## Modifier Keys
+### Automatic Key Modifers
+
+> New in 2.5.0+
+
+You can also directly use any valid key names exposed via [`KeyboardEvent.key`](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values) as modifiers by converting them to kebab-case:
+
+``` html
+<input @keyup.page-down="onPageDown">
+```
+
+In the above example, the handler will only be called if `$event.key === 'PageDown'`.
+
+<p class="tip">A few keys (`.esc` and all arrow keys) have inconsistent `key` values in IE9, their built-in aliases should be preferred if you need to support IE9.</p>
+
+## System Modifier Keys
 
 > New in 2.1.0
 
@@ -268,6 +282,20 @@ For example:
 
 <p class="tip">Note that modifier keys are different from regular keys and when used with `keyup` events, they have to be pressed when the event is emitted. In other words, `keyup.ctrl` will only trigger if you release a key while holding down `ctrl`. It won't trigger if you release the `ctrl` key alone.</p>
 
+### `.exact` Modifier
+
+> New in 2.5.0
+
+The `.exact` modifier should be used in combination with other system modifiers to indicate that the exact combination of modifiers must be pressed for the handler to fire.
+
+``` html
+<!-- this will fire even if Alt or Shift is also pressed -->
+<button @click.ctrl="onClick">A</button>
+
+<!-- this will only fire when only Ctrl is pressed -->
+<button @click.ctrl.exact="onCtrlClick">A</button>
+```
+
 ### Mouse Button Modifiers
 
 > New in 2.2.0+