react-keypress.js-wrapper

1.0.1 • Public • Published

Introduction

This is a library to Bind Keyboard shortcuts to react components

Installation

npm i react-keypress.js-wrapper

API

This library provides 3 components.

  1. Context Provider Component KeyboardShortcutsProvider

    import { KeyboardShortcutsProvider } from 'react-keypress.js-wrapper'
    

    You need to wrap it at the very top of your React App, preferably App.js. This just creates the context and passes it down to your app so that all of the shortcuts are stored somewhere.

  2. HOC Component withKeyboardShortcuts

    import { withKeyboardShortcuts } from 'react-keypress.js-wrapper'
    

    This is just a higher order component. This will provide all of the current active shortcuts to the passed components.

     function Component({
       keyboardShortcuts
     }) {
       // keyboardShortcuts will be an Array of Objects
       // value is passed shortcut value and 
       // description is passed description value
     }
     withKeyboardShortcuts(Component)
    
  3. Shortcut Component KeyboardShortcuts

    import { KeyboardShortcuts } from 'react-keypress.js-wrapper'
    

    Use this component to define the combo with the callback and the description. Use as

    <KeyboardShortcuts combo="shift r" callback={any_function} description="Magical Shortcut" />
    

Development

The code is stored inside src/lib and the rest of the code is just to check and run the app based upon the library.

Publish to npm

Run npm run build-lib followed by npm publish

Readme

Keywords

none

Package Sidebar

Install

npm i react-keypress.js-wrapper

Weekly Downloads

3

Version

1.0.1

License

none

Unpacked Size

4.5 kB

Total Files

3

Last publish

Collaborators

  • bugwheels94