Dependencies

This repository contains a set of native Angular directives based on Bootstrap's markup and CSS. As a result no dependency on jQuery or Bootstrap's JavaScript is required.

Here is a list of minimal required versions of ng-bootstrap, Angular and Bootstrap CSS for ng-bootstrap-extras:

ng-bootstrap-extras ng-bootstrap Angular Bootstrap CSS
1.x.x 4.0.0 7.0.0 4.0.0

Installation

After installing the above dependencies, install ng-bootstrap-extras via:

Once installed you need to import our main module.

Alternatively you could only import modules with components you need, ex. pagination and alert. The resulting bundle will be smaller in this case.


SystemJS

If you are using SystemJS, you should also adjust your configuration to point to the UMD bundle.

In your SystemJS config file, map needs to tell the System loader where to look for ng-bootstrap-extras:


Internationalization

Some components contain static English text or symbols that you might want to internationalize. Some of them appear on the screen, like for example the placeholders used in the timepicker input fields. Others appear in aria attributes used for accessibility.

Internationalizing the ng-bootstrap-extras components is done the same way as for any of your components, using the process described in the Angular documentation. The only difference is that we already did the first phase of this process: marking static text messages in the ng-bootstrap-extras component templates for translation.

So, if you execute `ng xi18n` on your project, you will also find the ng-bootstrap-extras messages to translate in the generated messages file. All our messages are identified by an ID of the form ngbx.[widget].[message]

Getting Help

Please, do not open issues for the general support questions as we want to keep GitHub issues for bug reports and feature requests. You've got much better chances of getting your question answered on StackOverflow where the community at large are looking at questions tagged with ng-bootstrap-extras.

StackOverflow is a much better place to ask questions since:

To save your and our time we will be systematically closing all the issues that are requests for general support and redirecting people to StackOverflow.