Modal
Display content or complete an action in a dialog.
Edit content
Custom footer
Destroying state and initial focus
Icon and description
Use icon and description to explain the action.
The body uses Scrollbar; long content scrolls while the heading and actions remain visible. Headers without a description and the footer use compact vertical spacing.
Modal API
ModalFooterActions
Types
Import types when defining reusable component props or assembling options.
Usage notes
Focus moves into the dialog when opened and returns to the trigger on dismissal. Tab stays within the dialog. Use maskClosable and keyboard to control backdrop and Escape dismissal. Supply aria-label when omitting title.
Customize footer actions or place a Form inside the body. Picker overlays inside a dialog retain its regional theme.
The default footer has Cancel followed by OK. With onConfirm, update open after the action; without it, OK calls onClose. Promises show loading and prevent duplicates. Submit forms with requestSubmit() in onConfirm or a submit type and form ID in confirmButtonProps. Native validation still applies. A footer function extends default buttons; footer={null} hides the footer.
DialogFocusOptions
Surfaces and rich content
Use description for supporting text and icon for a decorative heading icon. Divided dialogs have subtle dividers and a muted footer by default; divided={false} groups content with spacing. A footer function can add status text on the left. Group its buttons with Space so they wrap together and stay aligned to the right on narrow screens.