ember-keyboard
ember-keyboard
, an Ember addon for the painless support of keyboard events.
Features
- Dynamic priority levels allow you to specify which components respond first to key events and under what circumstances. (Thanks to
ember-key-responder
for the inspiration) - Human-readable key-mappings. (Thanks to
ember-keyboard-service
for the inspiration) - Glimmer-friendly template declarations for keyboard shortcuts (requires Ember 3.12 or higher)
- Support for
keyup
, keydown
, and keypress
, as well as the modifier keys: ctrl
, alt
, shift
, and meta
.
Compatibility
- ember-keyboard 6.x requires Ember 3.8 or higher
- For use with Ember 2.0 up to 3.8, use ember-keyboard 5.x.
Accessibility Considerations
In order to avoid adding keyboard shortcuts to your application that are already in use by assistive technology, please review the existing keyboard shortcuts and gestures available today: https://dequeuniversity.com/screenreaders/.
Installation
ember install ember-keyboard
Documentation & Demo
You can find interactive documentation here.
Upgrading from ember-keyboard 6.0.0-beta.0 to 6.0.0
The keyboard-press
component has been deprecated and replaced with the on-key
helper. The on-keyboard
and keyboard-shortut
modifiers have been deprecated and replaced with the on-key
modifier. The deprecations page has more info, along with the 5 to 6 upgrade guide immediately below.