useDisclosure

useDisclosure is a custom hook used to help handle common open, close, or toggle scenarios. It can be used to control feedback component such as Modal, AlertDialog, Drawer, etc.

Import#

import { useDisclosure } from '@chakra-ui/react'

Return value#

The useDisclosure hook returns an object with the following fields:

NameTypeDefaultDescription
isOpenbooleanfalseIf true, it sets the controlled component to its visible state.
onClosefunctionCallback function to set a falsy value for the isOpen parameter.
onOpenfunctionCallback function to set a truthy value for the isOpen parameter.
onTogglefunctionCallback function to toggle the value of the isOpen parameter.
getDisclosurePropsfunctionCallback function to retrieve a set of props for the controlled component.
getButtonPropsfunctionCallback function to retrieve a set of props for the button that triggers the disclosure.

Usage#

You can use a combination of the methods and values returned by the hook for various control of the components affected by the disclosure.

Below is the use of returned fields of the hook without a getter to control the Drawer component on button toggle.

function Example() {
const { isOpen, onOpen, onClose } = useDisclosure()
return (
<>
<Button onClick={onOpen}>Open Drawer</Button>
<Drawer placement='right' onClose={onClose} isOpen={isOpen}>
<DrawerOverlay />
<DrawerContent>
<DrawerHeader borderBottomWidth='1px'>Basic Drawer</DrawerHeader>
<DrawerBody>
<p>Some contents...</p>
<p>Some contents...</p>
<p>Some contents...</p>
</DrawerBody>
</DrawerContent>
</Drawer>
</>
)
}

Using the getDisclosureProps and getButtonProps methods returned by the hook provides the needed attributes and handlers to the respective component and button for visibility toggling and accessibility.

The component that uses getDisclosureProps receives the following props:

  • An id (can optionally pass this in as a prop to the hook to render a custom value).
  • A dynamically rendered hidden attribute.

getDisclosureProps can directly accept any additional props for the component.

The button that uses getButtonProps for toggling receives the following props:

  • A dynamically rendered aria-expanded attribute to let a screen reader know whether the disclosure component is visible.
  • The aria-controls attribute using the id (can optionally pass id in as a prop to the hook to render a custom value). This lets a screen reader know which component is controlled by the button.
  • An onClick handler that uses the onToggle callback along with any other click events passed as an onClick prop to getButtonProps

getButtonProps can also directly accept any additional props for the button.

function Basic() {
const { getDisclosureProps, getButtonProps } = useDisclosure()
const buttonProps = getButtonProps()
const disclosureProps = getDisclosureProps()
return (
<>
<Button {...buttonProps}>Toggle Me</Button>
<Text {...disclosureProps} mt={4}>
This text is being visibly toggled hidden and shown by the button.
<br />
(Inspect these components to see the rendered attributes)
</Text>
</>
)
}

Parameters#

The useDisclosure hook accepts an optional object with the following properties:

ParameterTypeDescription
isOpen (Optional)booleanIf true, the controlled component is responsible for changing the visible state via onClose and onOpen props.
defaultIsOpen (Optional)booleanIf true, it initially sets the controlled component to its visible state.
onClose (Optional)functionFunction to set a falsy value for the isOpen parameter.
onOpen (Optional)functionFunction to set a truthy value for the isOpen parameter.
id (Optional)stringString that allows you to associate the disclosure state with a specific component or element on your page.
Edit this page on GitHub

Proudly made inNigeria by Segun Adebayo

Deployed by â–² Vercel