One of the best javascript datagrid SlickGrid which was originally developed by @mleibman is now available to Angular. I have used a few datagrids and SlickGrid beats most of them in terms of functionalities and performance (it can easily deal with even a million row). We will be using the 6pac/SlickGrid fork, this is the most active fork since the original @mleibman fork was closed some time ago by his author for personal reasons. Also worth to know, I also contributed a lot to the 6pac/SlickGrid fork for the benefit of Angular-Slickgrid... also a reminder, this is a wrapper of a jQuery lib (SlickGrid), a big portion of the lib (like Editors, Filters and others) are written in jQuery/JavaScript, so just keep that in mind and it also means that jQuery is a dependecy.
You like and use this great library Angular-Slickgrid
? Be sure to upvote ⭐ and feel free to contribute. 👷
If you like my work, you can also support me with caffeine ☕ Buy Me a Coffee
I certainly drank many coffees to build and keep adding features for this great library.
Check out the Releases section for all latest News & Releases.
- version
1.x.x
for Angular 4 to 6- Angular 6, is only supported through
rxjs-compat
as shown in this post. It's preferable to upgrade to Angular 7+ to avoid using therxjs-compat
package.
- Angular 6, is only supported through
- version
2.x.x
for Angular 7+- since version
2.11.0
, you can also change your buildtarget
toES2015
for modern browser.
- since version
If you are facing any issue with ngx-translate
library while building your Angular Project. You need to make sure @ngx-translate/core
is part of your dependencies, even if you just use 1 Locale, because it is a peerDependency
of Angular-Slickgrid (we use @Optional() TranslateService
in the lib and for that to work, we still need it to be installed, but don't worry it should be removed by tree shaking process after a running a build). See their version compatibility table below
Angular Version | @ngx-translate/core |
---|---|
10 | 13.x+ |
9 | 12.x+ |
8 | 12.x+ |
7 | 11.x+ |
Since Angular 8+, a few warnings started to appear when doing a Prod build and that was asked in a few separate issues. These warnings are fine, the reason is because Angular-Slickgrid loads all of the SlickGrid extensions dynamically here depending on which flags you use in the grid options, with require('slickgrid/plugins/slick....');
and Angular is complaining about the use of require
(even though in our case we load dynamically to avoid adding plugins code in your build that you might not even use).
These warnings are normal so the best way to fix this, is to simply remove the warnings, all you have to do is to add a file named ngcc.config.js
in your project root (same location as the angular.json
file) with the following content (you can also see this commit which fixes the Angular-Slickgrid-Demos prod build):
module.exports = {
packages: {
'angular-slickgrid': {
ignorableDeepImportMatchers: [
/slickgrid\//,
/flatpickr/,
/jquery-ui-dist\//,
]
},
}
};
You should also add Angular-Slickgrid
as an allowed CommonJS dependency to your angular.json
file to silent the warning.
"options": {
"allowedCommonJsDependencies": [
"angular-slickgrid"
]
}
Angular-Slickgrid reached 100% Unit Test Coverage, we are talking about +10,000 lines of code (+2,700 unit tests) that are now fully tested with Jest. There are also over +350 Cypress E2E tests to cover most UI functionalities on nearly all Examples of Angular-Slickgrid.
Refer to the Wiki - HOWTO Step by Step and/or clone the Angular-Slickgrid Demos repository. Please don't open any issue unless you have followed these steps (from the Wiki), and if any of the steps are incorrect or confusing, then please let me know.
NOTE: if you have any question, please consider asking installation and/or general questions on Stack Overflow
Angular-Slickgrid
supports both Bootstrap 3
and Bootstrap 4
, you can see a demo of each one below.
There are also 2 new Themes, Material & Salesforce that are available as well and if you wish to use SVG then take a look at the Wiki - SVG Icons
For a complete and working local demo, you can clone the Angular-Slickgrid Demos repository. That repo is updated frequently and is used for demoing both the Bootstrap 3 demo and Bootstrap 4 demo.
git clone https://github.com/ghiscoding/angular-slickgrid-demos
cd bootstrap4-demo-with-translate
npm install
npm start
You might notice that all demos are coded with mocked dataset in each examples, that is mainly for demo purposes, but you might be wondering how to connect this with an HttpClient
? Easy... just replace the mocked data, assigned to the dataset
property, by your HttpClient
call and that's it. The dataset
property can be changed or refreshed at any time, which is why you can use local data and/or connect it to a Promise
or an Observable
with HttpClient
(internally it's just a SETTER that refreshes the grid). See Example 24 for a demo showing how to load a JSON file with HttpClient
.
You like the library and would like contribute? That would be awesome, the first thing you can do is head over to the Version 2.x - Project, there are some tasks that I would gladly like receiving help with. One of the biggest task is to increase Jest unit tests code coverage and/or more Cypress E2E tests.
The Wiki is where all the documentation and instructions will go, so please consult the Angular-Slickgrid - Wiki before opening any issues. The Wiki - HOWTO is a great place to start with. You can also take a look at the Demo page, it includes sample for most of the features and it keeps growing (so you might want to consult it whenever a new version comes out).
You can see some screenshots below and the instructions down below and if that is not enough for you to decide, head over to the Wiki - Main Features.
What if Angular-Slickgrid
is missing feature(s) compare to the original core library 6pac/SlickGrid?
Fear not, and just simply reference the SlickGrid
and DataView
objects, just like in the core lib, those are exposed through Event Emitters. For more info continue reading on Wiki - SlickGrid & DataView objects and Wiki - Grid & DataView Events
Screenshots from the demo app with the Bootstrap
theme.