useModal
useModal hook allows you to manage a modal. Since it is designed as headless, it returns the show and close functions and the visible state. It expects you to handle the UI.
const { show, close, visible } = useModal();
You can use the visible state to show or hide the modal. The show and close functions' only use is changing the visible state. You can use this hook anywhere.
Usageβ
Let's see an example:
import {
useModal,
} from "@refinedev/core";
export const PostList: React.FC = () => {
const { visible, show, close } = useModal();
return (
<>
<button onClick={show}>Show Modal</button>
{visible && (
<YourModalComponent>
<p>Dummy Modal Content</p>
<button onClick={close}>Close Modal</button>
</YourModalComponent>
)}
</>
);
};
Here, we show a button somewhere on the page and use show on its onClick callback to trigger the opening of the <YourModalComponent>. When the user clicks on the button, the <YourModalComponent> appears.
To demonstrate the close function, we created a <button> that uses it in its onClick property to close <YourModalComponent>
Propertiesβ
defaultVisibleβ
defaultVisible is a boolean value that determines whether the modal is visible by default. By default, it is false.
useModal({
defaultVisible: true,
});
Return Valuesβ
visibleβ
Visible state of the modal.
showβ
A function that can change the visible state to true.
closeβ
A function that can change the visible state to false.
API Referenceβ
Propertiesβ
| Property | Type | Description | Default |
|---|---|---|---|
defaultVisible | | Initial state of the modal | |
Return Valueβ
| Key | Description | Type |
|---|---|---|
| visible | Returns the visible state of the modal. | boolean |
| show | A function that can open the modal. | () => void |
| close | A function that can close the modal. | () => void |
Exampleβ
npm create refine-app@latest -- --example core-use-modal