bootstrap README

The project's README from github.com/angular-ui/bootstrap. As one markdown file: README.md.

Project Status (please read)

Due to Angular's continued adoption, our creation of the Angular version of this library, and the the project maintainers' moving on to other things, this project is considered feature-complete and is no longer being maintained.

We thank you for all your contributions over the years and hope you've enjoyed using this library as much as we've had developing and maintaining it. It would not have been successful without them.


UI Bootstrap - AngularJS directives specific to Bootstrap

Gitter Build Status devDependency Status CDNJS

Demo

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

Angular 2

Are you interested in Angular 2? We are on our way! Check out ng-bootstrap.

Installation

Installation is easy as UI Bootstrap has minimal dependencies - only the AngularJS and Twitter Bootstrap's CSS are required. Notes:

Angular Requirements

Bootstrap Requirements

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 https://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']);

Webpack / JSPM

To use this project with webpack, follow the NPM instructions. Now, if you want to use only the accordion, you can do:

import accordion from 'angular-ui-bootstrap/src/accordion';

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

You can import all the pieces you need in the same way:

import accordion from 'angular-ui-bootstrap/src/accordion';
import datepicker from 'angular-ui-bootstrap/src/datepicker';

angular.module('myModule', [accordion, datepicker]);

This will load all the dependencies (if any) and also the templates (if any).

Be sure to have a loader able to process css files like css-loader.

If you would prefer not to load your css through your JavaScript file loader/bundler, you can choose to import the index-nocss.js file instead, which is available for the modules:

The other modules, such as accordion in the example below, do not have CSS resources to load, so you should continue to import them as normal:

import accordion from 'angular-ui-bootstrap/src/accordion';
import typeahead from 'angular-ui-bootstrap/src/typeahead/index-nocss.js';

angular.module('myModule', [accordion, typeahead]);

Versioning

Pre-2.0.0 does not follow a particular versioning system. 2.0.0 and onwards follows semantic versioning. All release changes can be viewed on our changelog.

Support

FAQ

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

Code of Conduct

Take a moment to read our Code of Conduct

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:

Modern mobile browsers should work without problems.

Need help?

Need help using UI Bootstrap?

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.

bootstrap (angular-ui/bootstrap)

Searching Database…

14.1K ·GitHub
archived
Что это такое?UI Bootstrap — это библиотека нативных директив AngularJS, которые реализуют компоненты Bootstrap, так что вы получаете аккордеоны, модальные окна, всплывающие подсказки и многое другое без необходимости в jQuery или JS-файле Bootstrap.
Это фреймворк или просто набор виджетов?Это библиотека директив AngularJS, по одному модулю на каждый компонент (аккордеон, карусель, выбор даты, модальное окно, подсказка, typeahead и т. д.), которую вы добавляете как зависимость в своё приложение AngularJS.
Как подключить её к проекту?Установите через NPM, Bower или NuGet либо соберите собственный бандл, затем добавьте 'ui.bootstrap' как зависимость в модуль вашего приложения AngularJS; при использовании Webpack/JSPM импортируйте только нужные модули (например, только accordion).
Что ещё нужно, кроме этой библиотеки?Нужны AngularJS 1.4.x+ и CSS Bootstrap 3.x+; ngAnimate обязателен для переходов и анимаций, а ngTouch — для жестов свайпа, но jQuery и собственный JS-файл Bootstrap не требуются.
Проект до сих пор поддерживается?Нет — проект архивирован и прямо помечен как завершённый по функциональности, без дальнейшей поддержки; команда рекомендует пользователям AngularJS, которым нужен новый Angular, использовать вместо него ng-bootstrap.
Кому всё ещё стоит использовать эту библиотеку?Только командам, которые поддерживают существующие проекты на AngularJS (1.x) и уже используют CSS Bootstrap; для новых проектов лучше обратить внимание на ng-bootstrap или современные альтернативы для Angular.
Можно ли подключить только один компонент, а не всю библиотеку?Да, при использовании Webpack/JSPM можно импортировать отдельные модули, например только accordion, и тогда подтянутся только зависимости и шаблоны этого модуля.
Какие браузеры поддерживаются?Директивы тестируются в Chrome (стабильная и canary), Firefox, IE 9 и 10, Opera и Safari, и должны также работать в современных мобильных браузерах.
Creator
angular-ui
Size
9.7 MB
Stars
14.1K
Age
14y
Commits · 90 Days