Basic
Default
Most basic sample
Large modal
.modal-lg applies to .modal-dialog
Small modal
.modal-sm applies to .modal-dialog
Modal width
Feel free to add any desire width to .modal-dialog using inline style or .w-*px utility classes.
Modal types
Top
.modal-top applies to .modal
Center
.modal-center applies to .modal
Bottom
.modal-bottom applies to .modal
Left
.modal-left applies to .modal
Fill
.modal-fill applies to .modal
Right
.modal-right applies to .modal
Modaler
Modaler is a shorthand utility to create modals for a specified content. You can create any type of modals using modaler plugin. The content can be load from a specific URL, direct HTML or HTML of targeted element.
Examples using Javascript
Basic
Some options
Events
Examples using data attributes
Basic
Some options
Events
Usage
Trigger the modaler via JavaScript:
app.modaler(options)
Trigger the modaler via data-attribute when user click on the element:
<button data-provide="modaler" data-url="path/to/modal.html">Launch modaler</button>
Options
Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-url="value" or data-is-modal="value".
| Name | Type | Default | Description |
|---|---|---|---|
url |
String | null | Provide a URL that content should come from. It could be a content to insert inside .modal-body or a whole modal component (see isModal). |
isModal |
Boolean | false | If you are loading a modal component instead of a content, you should set this option to true.Please note that if it's true, the rest of options doesn't work anymore. |
html |
String | null | The HTML content to be inserted inside .modal-body. |
target |
String | null | A selector to retrive HTML from and insert inside .modal-body. |
type |
String | null | Any modal type from: top, bottom, left, right, center, fill, |
size |
String | null | sm, lg or any .w-* utility clasess. |
title |
String | null | Title of the modal. |
backdrop |
Boolean | true | Includes a modal-backdrop element. |
headerVisible |
Boolean | true | Modal should have .modal-header which contains title and close button. |
footerVisible |
Boolean | true | Modal should have .modal-footer which contains action buttons. |
confirmVisible |
Boolean | true | Include a confirm button in the footer. |
confirmText |
String | 'Ok' | Use this to change the text on the confirm button. |
confirmClass |
String | 'btn btn-w-sm btn-flat btn-primary' | Use this option to change appearance of confirm button. |
cancelVisible |
Boolean | false | Include a cancel button in the footer. |
cancelText |
String | 'Cancel' | Use this to change the text on the cancel button. |
cancelClass |
String | 'btn btn-w-sm btn-flat btn-secondary' | Use this option to change appearance of cancel button. |
bodyExtraClass |
String | null | Add extra classes to .modal-body. |
spinner |
String | See description | A HTML content to place inside .modal-body while the main content fetch from the URL. Default is: |
onShow |
Function | null | Function to run when the show.bs.modal event fires on the modal. |
onShown |
Function | null | Function to run when the shown.bs.modal event fires on the modal. |
onHide |
Function | null | Function to run when the hide.bs.modal event fires on the modal. |
onHidden |
Function | null | Function to run when the hidden.bs.modal event fires on the modal. |
onConfirm |
Function | null | Function to run when confirm button clicks, provides modal DOM element as the first argument. |
onCancel |
Function | null | Function to run when cancel button clicks, provides modal DOM element as the first argument. |