Skip to main content

useKeyPress

The useKeyPress hook is a custom React hook used to track if a specific key is currently pressed. It provides an easy way to handle keyboard interactions in your components.

Usage

Installation

You can import the useKeyPress hook from the hookstorm package like this:

import { useKeyPress } from "hookstorm";

Parameters

  • targetKey: A string representing the key to track (e.g., "Enter", "Escape").

Return Values

The useKeyPress hook returns the following object:

  • key: The key that is being tracked.
  • isPressed: A boolean indicating whether the key is currently pressed.

Example Usage

The following example demonstrates how to use the useKeyPress hook within a functional component:

import { ReactElement } from "react";
import { useKeyPress } from "hookstorm";

export default function KeyPressComponent(): ReactElement {
const { isPressed } = useKeyPress("Enter");

return (
<div>
<p>Enter key is {isPressed ? "pressed" : "not pressed"}</p>
</div>
);
}

Explanation

In the example above:

  • The useKeyPress hook is used to track if the "Enter" key is pressed.
  • The isPressed variable indicates whether the key is currently pressed.
  • The component displays a message showing the current state of the "Enter" key.

Conclusion

useKeyPress is a useful hook for handling keyboard interactions, allowing you to easily monitor and respond to key presses in your React applications.