@react-hook/toggle
v2.0.1
Published
A React hook for toggling between two values
Downloads
1,505
Maintainers
Readme
A React hook for toggling between two values
Quick Start
import useToggle from '@react-hook/toggle'
const Component = (props) => {
const [value, toggle] = useToggle(false, true)
return (
<button onClick={toggle}>
{value === false ? 'Toggle on' : 'Toggle off'}
</button>
)
}
API
useToggle(off?, on?, defaultValue?)
function useToggle<Off extends any, On extends any>(
off: Off,
on: On,
defaultValue: Off | On = off
): [Off | On, () => void]
| Argument | Type | Default | Required? | Description |
| ------------ | ---------- | ------- | --------- | ------------------------------------------------------------------ |
| off | Off
| false
| No | The value of the toggle in its off
state |
| on | On
| true
| No | The value of the toggle in its on
state |
| defaultValue | Off | On
| off
| No | The default value of the toggle, either the value of off
or on
|
LICENSE
MIT