README and bumped version
This commit is contained in:
33
README.md
Normal file
33
README.md
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
# hyperf-keybinds
|
||||||
|
|
||||||
|
Quickly handle keyboard shortcuts and sequences in your app.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install hyperf-keybinds
|
||||||
|
```
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import { createKeyHandler, KeybindEventTypes, ModifierKey } from 'hyperf-keybinds';
|
||||||
|
|
||||||
|
// Define a command
|
||||||
|
const commands = [
|
||||||
|
{ command: [{ key: 'KeyS', modifiers: [ModifierKey.Control] }], callback: () => console.log('Ctrl+S!') },
|
||||||
|
{ command: [{ key: 'KeyA', modifiers: []}, { key: 'KeyS', modifiers: []}], callback: () => console.log('a - s!')}
|
||||||
|
];
|
||||||
|
|
||||||
|
// Create handler and emitter
|
||||||
|
const { handler, emitter } = createKeyHandler(commands);
|
||||||
|
|
||||||
|
// Attach to window
|
||||||
|
window.addEventListener('keydown', handler);
|
||||||
|
|
||||||
|
// Listen to events
|
||||||
|
emitter.on(e => console.log(e.type));
|
||||||
|
```
|
||||||
|
|
||||||
|
Now Ctrl+S triggers your callback and emits events.
|
||||||
|
Pressing a then s triggers a separate callback.
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "hyperf-keybinds",
|
"name": "hyperf-keybinds",
|
||||||
"version": "0.1.0",
|
"version": "0.1.1",
|
||||||
"description": "",
|
"description": "",
|
||||||
|
|
||||||
"main": "dist/index.js",
|
"main": "dist/index.js",
|
||||||
|
|||||||
Reference in New Issue
Block a user