madrobby/keymaster
Keymaster
Keymaster is a keyboard shortcut library for web applications that provides utilities for intercepting keyboard events and mapping key combinations to handler functions. It includes a keyboard event manager and a key state tracker to monitor and query which keys or modifiers are currently held down.
The library features a scoped input handler that allows shortcuts to be grouped into named contexts. This enables the application to switch between different sets of available actions depending on the active area of the interface.
The system includes input filtering to prevent global shortcuts from triggering while a user is typing in text fields. It also supports the unbinding of shortcuts globally or within specific scopes.
Features
- Keyboard-to-Action Mappings - Maps specific keyboard input combinations to executable application actions.
- Modifier Key Listeners - Detects and combines modifier keys like Ctrl, Alt, and Shift to resolve multi-key shortcuts.
- Keyboard Event Handlers - Intercepts and filters keyboard input based on focus state or custom conditions.
- Shortcut Scope Management - Groups keyboard shortcuts into named namespaces that can be toggled based on the active application view.
- Keyboard Shortcut Mapping - Provides a system for mapping key combinations and modifiers to specific handler functions.
- Global Keyboard Event Listeners - Implements window-level keyboard event interception to route inputs to registered handlers.
- Input Event Filtering - Filters keyboard events to ensure global shortcuts do not fire while the user is typing in input fields.
- Held Key Trackers - Tracks the real-time state of pressed keys to support continuous input logic.
- DOM Focus Filtering - Prevents shortcut execution when specific DOM elements, such as text inputs, have focus.
- Key State Querying - Provides the ability to query whether specific keys or modifiers are currently being held down.
- General Utilities - Simple keyboard event listener.
- Keyboard Shortcuts - Small library for defining keyboard shortcuts.
- Keyboard Shortcuts - Micro-library for keyboard shortcuts.
