React Modal Component API

Modal API

Explore the API reference for the React Modal component and discover how to effectively utilize its props for customization.

CModal

jsx
import { CModal } from '@coreui/react'
PropertyDefaultType
alignment-'top', 'center'

Align the modal in the center or top of the screen.

backdroptrueboolean, 'static'

Apply a backdrop on body while modal is open.

className-string

A string of all className you want applied to the base component.

container5.3.0+-Element, DocumentFragment, (() => Element | DocumentFragment | null), null

Appends the react modal to a specific element. You can pass an HTML element or function that returns a single element. By default document.body.

focus4.10.0+trueboolean

Puts the focus on the modal when shown.

fullscreen-boolean, 'sm', 'md', 'lg', 'xl', 'xxl'

Set modal to covers the entire user viewport.

keyboardtrueboolean

Closes the modal when escape key is pressed.

onClose-(() => void)

Callback fired when the component requests to be closed.

onClosePrevented-(() => void)

Callback fired when the component requests to be closed.

onShow-(() => void)

Callback fired when the modal is shown, its backdrop is static and a click outside the modal or an escape key press is performed with the keyboard option set to false.

portaltrueboolean

Generates modal using createPortal.

scrollable-boolean

Create a scrollable modal that allows scrolling the modal body.

size-'sm', 'lg', 'xl'

Size the component small, large, or extra large.

transitiontrueboolean

Remove animation to create modal that simply appear rather than fade in to view.

unmountOnClosetrueboolean

By default the component is unmounted after close animation, if you want to keep the component mounted set this property to false.

visible-boolean

Toggle the visibility of modal component.

CModalBody

jsx
import { CModalBody } from '@coreui/react'
PropertyDefaultType
className-string

A string of all className you want applied to the base component.

CModalFooter

jsx
import { CModalFooter } from '@coreui/react'
PropertyDefaultType
className-string

A string of all className you want applied to the base component.

CModalHeader

jsx
import { CModalHeader } from '@coreui/react'
PropertyDefaultType
ariaCloseLabel5.13.0+-string

Sets the aria-label of the close button.

className-string

A string of all className you want applied to the base component.

closeButtontrueboolean

Add a close button component to the header.

CModalTitle

jsx
import { CModalTitle } from '@coreui/react'
PropertyDefaultType
ash5(ElementType & 'symbol') | (ElementType & 'object') | (ElementType & 'h5') | (ElementType & 'slot') | (ElementType & 'style') | ... 175 more ...

Component used for the root node. Either a string to use a HTML element or a component.

className-string

A string of all className you want applied to the base component.