If true, the modal will be open.
Modal
A modal is a dialog that focuses the user's attention exclusively on an information via a window that is overlaid on primary content.
Props#
Modal Props#
isOpenrequired
isOpenrequiredbooleanonCloserequired
onCloserequiredCallback invoked to close the modal.
() => voidallowPinchZoom
allowPinchZoomHandle zoom/pinch gestures on iOS devices when scroll locking is enabled.
booleanautoFocus
autoFocusIf true, the modal will autofocus the first enabled and interactive
element within the ModalContent
booleanblockScrollOnMount
blockScrollOnMountIf true, scrolling will be disabled on the body when the modal opens.
booleancloseOnEsc
closeOnEscIf true, the modal will close when the Esc key is pressed
booleantruecloseOnOverlayClick
closeOnOverlayClickIf true, the modal will close when the overlay is clicked
booleantruecolorScheme
colorSchemeColor Schemes for Modal are not implemented in the default theme. You can extend the theme to implement them.
stringfinalFocusRef
finalFocusRefThe ref of element to receive focus when the modal closes.
RefObject<FocusableElement>id
idThe id of the modal
stringinitialFocusRef
initialFocusRefThe ref of element to receive focus when the modal opens.
RefObject<FocusableElement>isCentered
isCenteredIf true, the modal will be centered on screen.
booleanfalselockFocusAcrossFrames
lockFocusAcrossFramesEnables aggressive focus capturing within iframes.
- If true: keep focus in the lock, no matter where lock is active
- If false: allows focus to move outside of iframe
booleanmotionPreset
motionPresetThe transition that should be used for the modal
MotionPresetscaleonCloseComplete
onCloseCompleteFires when all exiting nodes have completed animating out
(() => void)onEsc
onEscCallback fired when the escape key is pressed and focus is within modal
(() => void)onOverlayClick
onOverlayClickCallback fired when the overlay is clicked.
(() => void)portalProps
portalPropsProps to be forwarded to the portal component
Pick<PortalProps, "appendToParentPortal" | "containerRef">preserveScrollBarGap
preserveScrollBarGapIf true, a `padding-right` will be applied to the body element
that's equal to the width of the scrollbar.
This can help prevent some unpleasant flickering effect
and content adjustment when the modal opens
booleanreturnFocusOnClose
returnFocusOnCloseIf true, the modal will return focus to the element that triggered it when it closes.
booleansize
size"xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "full""md"trapFocus
trapFocusIf false, focus lock will be disabled completely.
This is useful in situations where you still need to interact with
other surrounding elements.
🚨Warning: We don't recommend doing this because it hurts the
accessibility of the modal, based on WAI-ARIA specifications.
booleanuseInert
useInertA11y: If true, the siblings of the modal will have `aria-hidden`
set to true so that screen readers can only see the modal.
This is commonly known as making the other elements **inert**
booleantruevariant
variantVariants for Modal are not implemented in the default theme. You can extend the theme to implement them.
stringOther components#
ModalOverlay,ModalHeader,ModalFooterandModalBodycomposesBoxcomponent.ModalCloseButtoncomposesCloseButton.
Props#
Modal Props#
isOpenrequired
isOpenrequiredIf true, the modal will be open.
booleanonCloserequired
onCloserequiredCallback invoked to close the modal.
() => voidallowPinchZoom
allowPinchZoomHandle zoom/pinch gestures on iOS devices when scroll locking is enabled.
booleanautoFocus
autoFocusIf true, the modal will autofocus the first enabled and interactive
element within the ModalContent
booleanblockScrollOnMount
blockScrollOnMountIf true, scrolling will be disabled on the body when the modal opens.
booleancloseOnEsc
closeOnEscIf true, the modal will close when the Esc key is pressed
booleantruecloseOnOverlayClick
closeOnOverlayClickIf true, the modal will close when the overlay is clicked
booleantruecolorScheme
colorSchemeColor Schemes for Modal are not implemented in the default theme. You can extend the theme to implement them.
stringfinalFocusRef
finalFocusRefThe ref of element to receive focus when the modal closes.
RefObject<FocusableElement>id
idThe id of the modal
stringinitialFocusRef
initialFocusRefThe ref of element to receive focus when the modal opens.
RefObject<FocusableElement>isCentered
isCenteredIf true, the modal will be centered on screen.
booleanfalselockFocusAcrossFrames
lockFocusAcrossFramesEnables aggressive focus capturing within iframes.
- If true: keep focus in the lock, no matter where lock is active
- If false: allows focus to move outside of iframe
booleanmotionPreset
motionPresetThe transition that should be used for the modal
MotionPresetscaleonCloseComplete
onCloseCompleteFires when all exiting nodes have completed animating out
(() => void)onEsc
onEscCallback fired when the escape key is pressed and focus is within modal
(() => void)onOverlayClick
onOverlayClickCallback fired when the overlay is clicked.
(() => void)portalProps
portalPropsProps to be forwarded to the portal component
Pick<PortalProps, "appendToParentPortal" | "containerRef">preserveScrollBarGap
preserveScrollBarGapIf true, a `padding-right` will be applied to the body element
that's equal to the width of the scrollbar.
This can help prevent some unpleasant flickering effect
and content adjustment when the modal opens
booleanreturnFocusOnClose
returnFocusOnCloseIf true, the modal will return focus to the element that triggered it when it closes.
booleansize
size"xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "full""md"trapFocus
trapFocusIf false, focus lock will be disabled completely.
This is useful in situations where you still need to interact with
other surrounding elements.
🚨Warning: We don't recommend doing this because it hurts the
accessibility of the modal, based on WAI-ARIA specifications.
booleanuseInert
useInertA11y: If true, the siblings of the modal will have `aria-hidden`
set to true so that screen readers can only see the modal.
This is commonly known as making the other elements **inert**
booleantruevariant
variantVariants for Modal are not implemented in the default theme. You can extend the theme to implement them.
stringOther components#
ModalOverlay,ModalHeader,ModalFooterandModalBodycomposesBoxcomponent.ModalCloseButtoncomposesCloseButton.