Giter Site home page Giter Site logo

ericlbarnes / bootstrap-modal Goto Github PK

View Code? Open in Web Editor NEW

This project forked from jschr/bootstrap-modal

1.0 1.0 1.0 190 KB

Extends the default Bootstrap Modal class. Responsive, stackable, ajax and more.

License: Apache License 2.0

JavaScript 100.00%

bootstrap-modal's Introduction

Bootstrap Modal v2.0

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 on body and can be accessed through the jQuery plugin interface.

$('body').modalmanager('loading');

Bootstrap-Modal can be used as a replacement for Bootstrap's Modal class or as a patch to the library.

Overview

  • Backwards compatible
  • Responsive
  • Stackable
  • Full width
  • Load content via AJAX
  • Disable background scrolling

Installation

  • Include css/bootstrap-modal.css after the main bootstrap css files.

  • Include js/bootstrap-modalmanager.js and js/bootstrap-modal.js after the main bootstrap js files.

    <script src="js/bootstrap.js"></script> <script src="js/bootstrap-modalmanager.js"></script> <script src="js/bootstrap-modal.js"></script>

Options

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-body.

  • loading Toggle the loading state.

  • spinner Provide a custom image or animation for the loading spinner.

  • consumeTab Used to enable tabindexing for modals with data-tabindex. This is set to true by default.

  • focusOn The element or selector to set the focus to once the modal is shown.

  • attentionAnimation Set the animation used by the attention method. Any animation in animate.css is supported but only the shake animation is included by default.

  • modalOverflow Set this property to true for modals with highly dynamic content. This will force the modal to behave as if it is larger than 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

  • loading Toggle the loading state.

  • backdropLimit Limit the amount of backdrops that will appear on the page at the same time.

  • spinner Provide a custom image or animation for the loading spinner.

Disable Background Scrolling

If you want to prevent the background page from scrolling (see demo for example) you must wrap the page contents in a <div class="page-container">. For example:

<body>
	<div class="page-container">
		<div class="navbar navbar-fixed-top">...</div>
		<div class="container">...</div>
	</div>
</body>

The reason for doing this instead of just simply setting overflow: hidden when a modal is open is to avoid having the page shift as a result of the scrollbar appearing/disappearing. This also allows the document to be scrollable when there is a tall modal but only to the height of the modal, not the entire page.

Constrain Modal to Window Size

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.

Tab Index for Modal Forms

You can use data-tabindex instead of the default tabindex to specify the tabindex within a modal.

<input type="text" data-tabindex="1" />
<input type="text" data-tabindex="2" />

See the stackable example on the demo page for an example.

bootstrap-modal's People

Contributors

ericlbarnes avatar jahvi avatar msurguy avatar

Stargazers

 avatar

Watchers

 avatar

Forkers

mohitsadaria

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.