NG Bootstrap - Angular powered Bootstrap widgets
Table of Contents
- Supported browsers
- Getting help
- You think you've found a bug?
- Contributing to the project
- Code of conduct
Please check all components we have in action at https://ng-bootstrap.github.io
You need to have an Angular project with the supported Angular version. We strongly recommend using Angular CLI for this.
You also need to add Bootstrap 4 CSS to your application by using your preferred way (it really depends on the setup you're using). Ex. for Angular CLI you can get Bootstrap from npm and update your
angular.json with something like:
popper.js as ng-bootstrap's goal is to completely replace them.
After installing the above dependencies, install
npm install --save @ng-bootstrap/ng-bootstrap
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.
If you're using Angular >= 9.0.0 and ng-bootstrap >= 6.0.0, you might also need to install the
ng add @angular/localize
See more details in the official documentation.
We support the same browsers and versions supported by both Bootstrap 4 and Angular, whichever is more restrictive. See Angular browser support and Bootstrap browser support for more details, but on the high-level it should be something like:
- Chrome (45+)
- Firefox (40+)
- IE (10+)
- Edge (20+)
- Safari (7+)
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 maintainers are looking at questions tagged with
StackOverflow is a much better place to ask questions since:
- there are hundreds of people willing to help on StackOverflow
- questions and answers stay available for public viewing so your question / answer might help someone else
- SO voting system assures that the best answers are prominently visible.
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.
You think you've found a bug?
We want to fix it ASAP! But before fixing a bug we need to reproduce and confirm it.
We ask you to respect two things:
- fill the GitHub issue template by providing the bug description and appropriate versions of Angular, ng-bootstrap and TypeScript
- provide a use-case that fails with a minimal reproduction scenario using StackBlitz (you can start by forking one from our demo page)
A minimal reproduction scenario allows us to quickly confirm a bug (or point out a coding problem) as well as confirm that we are fixing the right problem.
Please note that we will be insisting on a minimal reproduce scenario in order to save maintainers time and ultimately be able to fix more bugs. We'll mark the issue as non-actionable without it and close if not heard from the reporter.
Interestingly, from our experience users often find coding problems themselves while preparing a minimal StackBlitz. We understand that sometimes it might be hard to extract essentials bits of code from a larger code-base but we really need to isolate the problem before we can fix it.
Contributing to the project
Code of conduct
Please take a moment and read our Code of Conduct