Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 1 | espaco | 1 | # Bootbox - Bootstrap powered alert, confirm and flexible dialog boxes |
| 2 | |||
| 3 | Please see http://bootboxjs.com for full usage instructions, or head over to http://paynedigital.com/bootbox for |
||
| 4 | the original writeup about the project. |
||
| 5 | |||
| 6 | ## Contact |
||
| 7 | |||
| 8 | [](https://gitter.im/makeusabrew/bootbox?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) |
||
| 9 | |||
| 10 | The easiest thing is to [find me on twitter @makeusabrew](http://twitter.com/makeusabrew). |
||
| 11 | |||
| 12 | ## Contributing |
||
| 13 | |||
| 14 | Please see the [CONTRIBUTING](https://github.com/makeusabrew/bootbox/blob/master/CONTRIBUTING.md) file for guidelines. |
||
| 15 | |||
| 16 | ## Running Tests [](http://travis-ci.org/makeusabrew/bootbox) |
||
| 17 | |||
| 18 | Tests are run using [Karma](http://karma-runner.github.io/0.8/index.html) using the Mocha test adapter. |
||
| 19 | To run the tests yourself, simply run ```npm install``` within the project followed by ```npm test```. |
||
| 20 | Please note that this will require [PhantomJS](http://phantomjs.org/) being installed and in your path - if |
||
| 21 | it is not, you may run the tests and capture browsers manually by running ```karma start``` from the root |
||
| 22 | of the project. |
||
| 23 | |||
| 24 | The project is also hosted on [Travis CI](https://travis-ci.org/makeusabrew/bootbox) - when submitting |
||
| 25 | pull requests **please** ensure your tests pass as failing requests will be rejected. See the |
||
| 26 | [CONTRIBUTING](https://github.com/makeusabrew/bootbox/blob/master/CONTRIBUTING.md) file for more information. |
||
| 27 | |||
| 28 | ## Building a minified release |
||
| 29 | |||
| 30 | The repository no longer contains a minified bootbox.min.js file - this is now only generated |
||
| 31 | [for releases](https://github.com/makeusabrew/bootbox/releases). To build your own minified copy |
||
| 32 | for use in development simply run ```npm install``` if you haven't already, followed by ```grunt uglify```. |
||
| 33 | This will generate a bootbox.min.js file in your working directory. |
||
| 34 | |||
| 35 | ## A note on Bootstrap dependencies |
||
| 36 | |||
| 37 | Bootbox **4.0.0** is the first release to support Bootstrap 3.0.0. |
||
| 38 | |||
| 39 | Bootbox **3.3.0** is the *last* release to support Bootstrap 2.2.x. |
||
| 40 | |||
| 41 | Much more dependency information can be found [on the Bootbox website](http://bootboxjs.com/#dependencies). |
||
| 42 | |||
| 43 | ### Roadmap |
||
| 44 | |||
| 45 | The latest major release of Bootbox - 4.0.0 - involved a total rewrite of the |
||
| 46 | internal code and introduced an entirely new public API. It has not re-implemented |
||
| 47 | some functionality from the 3.x series as of yet; this will be addressed in the |
||
| 48 | the form of new minor releases. Please feel free to add feedback and requests. |
||
| 49 | |||
| 50 | There is no new major (e.g. 5.x) release on the roadmap at present. |
||
| 51 | |||
| 52 | ### Latest Release: 4.4.0 |
||
| 53 | |||
| 54 | * Allow `backdrop` options of `true` and `false` to dismiss modals |
||
| 55 | * Pass dialog as `this` value in callbacks |
||
| 56 | * Bootstrap 3.3.2 compatibility |
||
| 57 | * jQuery 1.11.2 compatibility |
||
| 58 | * Add support for `maxlength` prompt input attribute |
||
| 59 | * Gracefully detect lack of Bootstrap library rather than crashing |
||
| 60 | * Expose `addLocale` and `removeLocale` for custom locale settings |
||
| 61 | * Expose `setLocale` helper to select a locale rather than using `setDefaults("locale", ...)` |
||
| 62 | * Add Hungarian locale |
||
| 63 | * Add Croatian locale |
||
| 64 | * Add Bulgarian locale |
||
| 65 | * Add Thai locale |
||
| 66 | * Add Persian locale |
||
| 67 | * Add Albanian locale |
||
| 68 | |||
| 69 | For a full list of releases and changes please see [the changelog](https://github.com/makeusabrew/bootbox/blob/master/CHANGELOG.md). |
||
| 70 | |||
| 71 | ## License |
||
| 72 | |||
| 73 | (The MIT License) |
||
| 74 | |||
| 75 | Copyright (C) 2011-2015 by Nick Payne <nick@kurai.co.uk> |
||
| 76 | |||
| 77 | Permission is hereby granted, free of charge, to any person obtaining a copy |
||
| 78 | of this software and associated documentation files (the "Software"), to deal |
||
| 79 | in the Software without restriction, including without limitation the rights |
||
| 80 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||
| 81 | copies of the Software, and to permit persons to whom the Software is |
||
| 82 | furnished to do so, subject to the following conditions: |
||
| 83 | |||
| 84 | The above copyright notice and this permission notice shall be included in |
||
| 85 | all copies or substantial portions of the Software. |
||
| 86 | |||
| 87 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||
| 88 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||
| 89 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||
| 90 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||
| 91 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
||
| 92 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
||
| 93 | THE SOFTWARE |