One of the best JavasSript data grid SlickGrid, which was originally developed by @mleibman, is now available to the Angular world. SlickGrid beats most other data grids in terms of features, customizability and performance (running smoothly with even a million rows). Angular-Slickgrid is a wrapper on top of Slickgrid-Universal (which is a dependency), in the early beginning we used the 6pac/SlickGrid fork but that was dropped in >=v7.0 since Slickgrid-Universal is now a standalone project. SlickGrid was also recently rewritten with browser native code (no more jQuery 🎉).
📕 Documentation website powered by GitBook for version 7+ (or use the Wikis for older versions).
For common issues, see the Troubleshooting Section below
Available in Stackblitz (Codeflow) below, this can also be used to provide an issue repro.
A good starting point is the Docs - Quick Start and/or simply clone the Angular-Slickgrid Demos repository. Please review all documentation and closed issues before opening any new issue, also consider asking installation and/or general questions on Stack Overflow unless you think there's a bug with the library.
npm install angular-slickgridimport { type Column, type GridOption } from 'angular-slickgrid';
export class GridComponent implements OnInit {
columnDefinitions: Column[] = [];
gridOptions!: GridOption;
dataset!: any[];
onInit() {
this.columnDefinitions = [
{ id: 'username', name: 'Username', field: 'username'},
{ id: 'age', name: 'Age', field: 'age' }
];
this.gridOptions = { /*...*/ };
this.dataset = [
{ id: 1, username: 'John', age: 20 },
{ id: 2, username: 'Jane', age: 21 }
];
}
}<angular-slickgrid gridId="grid2"
[columnDefinitions]="columnDefinitions"
[gridOptions]="gridOptions"
[dataset]="dataset">
</angular-slickgrid>Warning
This project does not work well with strictTemplates because of its use of native Custom Event, so please make sure to either disable strictTemplates or cast your event as any (see this discussion for more info)
Multiple styling themes are available
- Bootstrap (see all Angular-Slickgrid live demos)
- Material (see Slickgrid-Universal)
- Salesforce (see Slickgrid-Universal)
Also note that all of these themes also have Dark Theme equivalent and even though Bootstrap if often used as the default, it also works well with any other UI framework like Bulma, Material, ...
Angular-Slickgrid works with all Bootstrap versions, you can see a demo of each one below. It also works well with any other frameworks like Material or Bulma and there are also couple of extra styling themes based on Material & Salesforce which are also available. You can also use different SVG icons, you may want to look at the Docs - SVG Icons
Angular-Slickgrid-Demos includes the following:
- Bootstrap 5 demo / examples repo - Code samples which uses
ngx-translateto support multiple locales. - Bootstrap 5 (single Locale) / examples repo - Code Sample with a single Locale (without
ngx-translate)
For a complete set of working demos (40+ examples), we strongly suggest you clone Angular-Slickgrid Demos repository (instructions are provided in the demo repo). The repo provides multiple demos and they are updated for every new project release, so it is updated frequently and is also used as the GitHub live demo page for both the Bootstrap 5 demo and Bootstrap 5 demo (single Locale).
git clone https://github.com/ghiscoding/angular-slickgrid-demos
cd bootstrap5-demo-with-translate # or any of the other demos
npm install
npm startYou like to use Angular-Slickgrid? Be sure to upvote ⭐ and maybe support me with caffeine ☕ and feel free to contribute. 👷👷♀️
If you wish to contribute then make sure to follow the steps shown in the CONTRIBUTING guide.
Check out the Releases section for all latest News & Releases.
Note please be aware that only the latest version of Angular-Slickgrid is supported and will receive bug fixes. The reason older versions are not supported is simply because it's already a lot of work to maintain for a single developer.
| Angular-Slickgrid | Angular version | Migration Guide | Notes |
|---|---|---|---|
| 8.x | >=18.0 | Migration 8.x | Modern UI / Dark Mode, requires Slickgrid-Universal 5.x version |
| 7.x | >=17.0 | Migration 7.x | merge SlickGrid into Slickgrid-Universal, requires Slickgrid-Universal 4.x version |
| 6.x | >=16.0 | Migration 6.x | removal of jQuery (now uses browser native code), requires Slickgrid-Universal 3.x version |
| 5.x | >=14.0 | Migration 5.x | removal of jQueryUI, requires Slickgrid-Universal 2.x version |
| 4.x | >=13.0 | Migration 4.x | for Ivy build only, requires Slickgrid-Universal 1.x version |
| 3.x | >=12.0 | Migration 3.x | the lib now uses Slickgrid-Universal monorepo v0.19.2. Also, IE11 is EOL and no longer supported. |
| 2.x | 7-11.x | Migration 2.x | support multiple grids on same page |
| 1.x | 4-6.x |
Note For a full compatibility table of Angular-Slickgrid with Slickgrid-Universal, please take a look at the Versions Compatibility Table - Wiki.
For Angular 12+ see the instructions below - Angular 12 with WebPack 5 - polyfill issue.
Angular-Slickgrid uses ngx-translate library to support Locales, it is also required that is even when using a single Locale. The reason is because, we use @Optional() TranslateService in the lib and for that to work, it requires ngx-translate to be installed. Once you run the build and if you are using a single Locale then the tree shaking process should remove these optional dependencies. See their version compatibility table below for more info
| Angular Version | @ngx-translate/core |
|---|---|
| 16+ | 15.x |
| 13+ (Ivy only) | 14.x |
| 10-13 | 13.x |
| 8-9 | 12.x |
| 7 | 11.x |
Slickgrid-Universal has 100% Unit Test Coverage and all Angular-Slickgrid Examples are tested with Cypress as E2E tests.
- Angular 12 with WebPack 5 - how to fix polyfill error
ngccBuild Warnings (Angular >=8.0 && <16.0)strictTemplateserror
