1.0.3 • Published 12 months ago

react-hotkey-hook v1.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

React Hotkey Hook

A react hook which can execute any function for any keyboard shortcut.

Installation

Install the package with npm or yarn with either of the following commands.

npm i react-hotkey-hook
yarn add react-hotkey-hook

Make sure to import the useHotkey hook from the library after it is installed

import useHotkey from "react-hotkey-hook";

Usage

import "./App.css";
import React from "react";
import useHotkey from "react-hotkey-hook";

function App() {
  const onKeyPress = () => {
    console.log("key pressed");
  };

  useHotkey("Control+a", true, onKeyPress);

  useHotkey("Shift+A", true, onKeyPress);

  return (
    <div className="container">
      <h1>Example for React Hotkey Hook</h1>
    </div>
  );
}

export default App;

Options

All options are optional and have a default value which you can override to change the behavior of the hook.

OptionTypeDescription
hotkeysstringThe combination of hotkeys.
overidebooleanOptional Parameter. Prevents default event when true. True on default.
callback() => voidFunction that will be called when the combination of keys are pressed.

License

Distributed under the MIT License. See LICENSE for more information.