Skip to main content

useToggle

The useToggle hook is a custom React hook used to manage a boolean state. This hook allows you to toggle your state (turning it on and off) and set the initial value of the state.

Usage​

Installation​

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

import { useToggle } from "hookstorm";

Parameters​

  • initialValue: (optional) A boolean representing the initial state. The default value is false.

Return Values​

The useToggle hook returns the following object:

  • value: A boolean representing the current state value.
  • toggle: A function that toggles the state value. It can accept an optional new value. If no new value is provided, it will toggle the current state.

Example Usage​

The following example shows how to use the useToggle hook within a functional component:

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

export default function ToggleComponent(): ReactElement {
const { value, toggle } = useToggle();

return (
<div>
<p>Status: {value ? "On" : "Off"}</p>
<button onClick={toggle}>Toggle</button>
<button onClick={() => toggle(true)}>On</button>
<button onClick={() => toggle(false)}>Off</button>
</div>
);
}

Explanation​

In the example above, the ToggleComponent works as follows:

  • The useToggle hook is called, and the value and toggle function are obtained.
  • A text element displays the current status (on or off).
  • When the user clicks the "Toggle" button, the state value is toggled.
  • When the "On" or "Off" buttons are clicked, the state is set directly to the specified value.

Conclusion​

useToggle is a simple and effective hook that makes it easier to manage boolean states. You can use it to handle state changes in your projects.