See live demo here.
Extends Bootstrap's native modals to provide additional functionality. Introduces a ModalManager class that operates behind the scenes to handle multiple modals by listening on their events.
A single ModalManager is created by default that can be accessed through the GlobalModalManager
variable.
Can be used as a replacement for Bootstrap's Modal class or as a patch to the library.
- Backwards compatible
- Responsive
- Stackable
- Full width
- Load content via AJAX
- Disable background scrolling
-
Include
css/bootstrap-modal.css
after the main bootstrap css files. -
Include
<script src="js/bootstrap.js"></script> <script src="js/bootstrap-modalmanager.js"></script> <script src="js/bootstrap-modal.js"></script>js/bootstrap-modalmanager.js
andjs/bootstrap-modal.js
after the main bootstrap js files. Note thatbootstrap-modal
must be included afterbootstrap-modalmanager
.
In addition to the standard bootstrap options, you now have access to the following options
Modal
-
width Set the inital width of the modal.
-
height Set the inital height of the modal.
-
maxHeight Set the max-height of the modal.
-
loading Toggle the loading state.
-
spinner Provide a custom image or animation for the loading spinner
-
modalOverflow Set this property to true for modals with highly dynamic content. This will force the modal behave as if it is larger then the viewport.
-
manager Set the modal's manager. By default this is set to the GlobalModalManager and will most likely not need to be overridden.
ModalManager
- spinner Provide a custom image or animation for the loading spinner
If you want to prevent the background page from scrolling (see demo for example) there is one extra step required. You must wrap the page contents in a <div class="page-container">
and provide a <div class="modal-container">
. For example:
<body>
<div class="page-container">
<div class="navbar navbar-fixed-top">...</div>
<div class="container">...</div>
</div>
<div class="modal-container">
<!-- You can put your modal definitions here but it is not required -->
</div>
</body>
The reason for doing this instead of just simply setting overflow: hidden
when a modal is open is because I wanted to avoid having the page shift as a result of the scrollbar appearing/disappearing. I also require that the document be scrollable when there is a tall modal but only wanted it to scroll to fit the height of the modal, not the entire page.
You can bind the the height of the modal body to the window with something like this:
$.fn.modal.defaults.maxHeight = function(){
// subtract the height of the modal header and footer
return $(window).height() - 165;
}
Note: This will be overwritten by the responsiveness and is only set when the modal is displayed, not when the window is resized.
On mobile safari, the background page will still scroll if the modal is smaller then the window size. We get desired behaviour if the modal is larger then the window however.
It seems like iOS6 has somewhat resolved this issue but is still not perfect.