Modal dialogs
Modal dialog is a small window that communicates information to the user and prompt them for a response. Dialog boxes are classified as
"modal" or "modeless", depending on whether or not they block interaction with the page that initiated the dialog. Table below contains basic modal dialog examples. Click Launch button to run modal examples.
| Basic modals | ||
|---|---|---|
| Default modal dialog | Basic modal dialog with header, body and footer areas. Default examples displays: header - contains a title and a close button; footer - contains buttons and body contains static or dynamic content |
|
| Modal with icons | Modal with icons added to the specified elements: heading title, footer control buttons and text inside modal body | |
| Disable backdrop | Disable backdrop element using data-bs-backdrop="false" or alternatively, specify static for a backdrop which doesn't close the modal on click |
|
| Disable keyboard interaction | Disabled keyboard interaction. If data-bs-keyboard option is set to false, the modal can't be closed when escape key is pressed. Make sure data-bs-backdrop is also set to static |
|
| Disable animation | Disabled animation. For modals that simply appear rather than fade in to view, remove the .fade class from your modal container |
|
| Scrollable modal | Scrollable modal that allows scroll the modal body by adding .modal-dialog-scrollable to .modal-dialog container |
|
| Vertically centered | By default, all modals are displayed in the upper part of the screen with some distance from the top edge. You can center the modal on the screen by adding .modal-dialog-centered to dialog container |
|
| Remote source | Default Bootstrap's remote source option replacement using a few lines of vanilla JS and onShow event |
|
| Modal sizing | ||
| Mini size | Modal in mini size. Mini modal width is 300px. To use, add modal-xs class to .modal-dialog container |
|
| Small size | Modal in small size. Small modal width is 400px. To use, add modal-sm class to .modal-dialog container |
|
| Default size | Modal in default size. Default modal width is 600px. Since this is a default size, modal markup doesn't require any additional sizing classes |
|
| Large size | Modal in large size. Large modal width is 900px. To use, add modal-lg class to .modal-dialog container |
|
| Extra large size | Modal in extra large size. Extra large modal width is 1140px. To use, add modal-xl class to .modal-dialog container |
|
| Full size | Modal in full width size. This modal has 94% width of the window. To use, add modal-full class to .modal-dialog container |
|
| Optional modal colors | ||
| Default modal theme | Default color theme. All areas of this modal dialog have white background color. Doesn't require any additional contextual classes |
|
| Primary modal header | Primary modal. To use, add .bg-primary.text-white class to the .modal-header container and .btn-close-white to close button in modal header |
|
| Danger modal header | Danger modal. To use, add .bg-danger.text-white class to the .modal-header container and .btn-close-white to close button in modal header |
|
| Success modal header | Success modal. To use, add .bg-success.text-white class to the .modal-header container and .btn-close-white to close button in modal header |
|
| Warning modal header | Warning modal. To use, add .bg-warning.text-white class to the .modal-header container and .btn-close-white to close button in modal header |
|
| Info modal header | Info modal. To use, add .bg-info.text-white class to the .modal-header container and .btn-close-white to close button in modal header |
|
| Custom modal header color | Modal with custom color added to the modal header. To use, add any color class from the color system to the .modal-header container and .btn-close-white to close button in modal header |
|
| Custom modal background color | Modal dialog with solid custom background color. To use, add any color class from the color system to the .modal-content container. Additionaly, you can also add a custom background color to the modal header |
|
| Form components | ||
| Vertical form | Modal with default vertical form layout and responsive grid. Forms must be placed outside of .modal-body container to prevent extra horizontal padding |
|
| Horizontal form | Modal with horizontal form layout. It does also support responsive grid, but in this case it will look best in wider modals | |
| Inline form | Modal with with a simple inline form layout |
|
| Heading options | ||
| Modal with H1 heading | Modal title in H1 size. In all heading sizes, vertical position of a close button will be automatically adjusted to the middle of the modal header |
|
| Modal with H2 heading | Modal title in H2 size |
|
| Modal with H3 heading | Modal title in H3 size |
|
| Modal with H4 heading | Modal title in H4 size |
|
| Modal with H5 heading | Modal title in H5 size |
|
| Modal with H6 heading | Modal title in H6 size |
|
| Modal with basic title | Modal title could be either a standard heading or any other component, but make sure you have included .modal-title class to it |
|
| Modal with subtitle | Modal title subtitle. This can be either inline or block. You can also use regular <div> or <span> element outside the heading, or <small> inside heading |
|
| Modal events | ||
| onShow event | This event fires immediately when the show instance method is called. If caused by a click, the clicked element is available as the relatedTarget property of the event |
|
| onShown event | This event is fired when the modal has been made visible to the user (will wait for CSS transitions to complete). If caused by a click, the clicked element is available as the relatedTarget property of the event |
|
| onHide event | This event is fired immediately when the hide instance method has been called |
|
| onHidden event | This event is fired when the modal has finished being hidden from the user (will wait for CSS transitions to complete) | |
| Programmatic dialog boxes | ||
| Alert dialog | Example of an alert dialog replacement with default Bootstrap modals |
|
| Confirm dialog | Example of a confirmation dialog replacement with default Bootstrap modals including callback |
|
| Prompt dialog | Example of a prompt dialog replacement with default Bootstrap modals including callback |
|
| Prompt with default value | Example of a prompt dialog replacement with default value |
|
| Custom bootbox dialog | Example of a custom bootbox dialog with multiple buttons and callbacks | |
| Dialog with form | Example of a custom bootbox dialog with simple form and callbacks | |
