UI Bootstrap - AngularJS directives specific to Bootstrap

Quick links

• Demo
• Installation
  • NPM
  • Bower
  • NuGet
  • Custom
  • Manual
• Support
  • FAQ
  • PREFIX MIGRATION GUIDE
  • Supported browsers
  • Old Docs
  • Need help?
  • Found a bug?
• Contributing to the project
• Development, meeting minutes, roadmap and more.

Demo

Do you want to see directives in action? Visit http://angular-ui.github.io/bootstrap/!

Installation

Installation is easy as UI Bootstrap has minimal dependencies - only the AngularJS and Twitter Bootstrap's CSS are required. Note: Since version 0.13.0, UI Bootstrap depends on ngAnimate for transitions and animations, such as the accordion, carousel, etc. Include ngAnimate in the module dependencies for your app in order to enable animation.

Additionally, it is srongly recommended that for UI Bootstrap 0.13.3 and higher you use Angular 1.3.18 or higher due to animation fixes.

Install with NPM

$ npm install angular-ui-bootstrap

This will install AngularJS and Bootstrap NPM packages.

Install with Bower

$ bower install angular-bootstrap

Note: do not install 'angular-ui-bootstrap'. A separate repository - bootstrap-bower - hosts the compiled javascript file and bower.json.

Install with NuGet

To install AngularJS UI Bootstrap, run the following command in the Package Manager Console

PM> Install-Package Angular.UI.Bootstrap

Custom build

Head over to http://angular-ui.github.io/bootstrap/ and hit the Custom build button to create your own custom UI Bootstrap build, just the way you like it.

Manual download

After downloading dependencies (or better yet, referencing them from your favorite CDN) you need to download build version of this project. All the files and their purposes are described here: https://github.com/angular-ui/bootstrap/tree/gh-pages#build-files Don't worry, if you are not sure which file to take, opt for ui-bootstrap-tpls-[version].min.js.

Adding dependency to your project

When you are done downloading all the dependencies and project files the only remaining part is to add dependencies on the ui.bootstrap AngularJS module:

angular.module('myModule', ['ui.bootstrap']);

If you're a Browserify or Webpack user, you can do:

var uibs = require('angular-ui-bootstrap');

angular.module('myModule', [uibs]);

Support

FAQ

https://github.com/angular-ui/bootstrap/wiki/FAQ

PREFIX MIGRATION GUIDE

If you're updating your application to use prefixes, please check the migration guide.

Supported browsers

Directives from this repository are automatically tested with the following browsers:

• Chrome (stable and canary channel)
• Firefox
• IE 9 and 10
• Opera
• Safari

Modern mobile browsers should work without problems.

Old Docs

For the time being, we don't have versioned docs (we are open for a good PR to fix that). If you need to read the old doc, please check the wiki.

Need help?

Need help using UI Bootstrap?

• Live help in the IRC (#angularjs channel at the freenode network). Use this webchat or your own IRC client.
• Ask a question in StackOverflow under the angular-ui-bootstrap tag.

Please do not create new issues in this repository to ask questions about using UI Bootstrap

Found a bug?

Please take a look at CONTRIBUTING.md and submit your issue here.

---

Contributing to the project

We are always looking for the quality contributions! Please check the CONTRIBUTING.md for the contribution guidelines.

Development, meeting minutes, roadmap and more.

Head over to the Wiki for notes on development for UI Bootstrap, meeting minutes from the UI Bootstrap team, roadmap plans, project philosophy and more.