Migration Guide to 6.x
SlickGrid is now jQuery free 🌊
In our previous v5.0 release (see Migration to v5.0), we dropped jQueryUI and now in v6.0 we are going even further and are now dropping jQuery entirely. You can still use jQuery but it's no longer a dependency. There are multiple benefits in dropping jQuery and go the vanilla route, the biggest advantages are:
it should provide better performance (browser native)
build size should be smaller (see table below)
Major Changes - Quick Summary
minimum requirements bump
Angular
>=16.0.0
RxJS
>=8.7.1
we dropped jQuery requirement
it also required us to rewrite the
multiple-select
(jQuery based lib) into a brand newmultiple-select-vanilla
lib which is now native and has zero dependency
NOTE: if you come from an earlier version other than 5.x, please make sure to follow each migration in their respected order
Changes
Dynamically Loading Component via AngularUtilService
AngularUtilService
as shown in (Example 21 - Row Detail / Example 22 - Angular Components)
In our AngularUtilService
we were dynamically creating component by using ComponentFactoryResolver
but that got removed in Angular 16 and so we had to replace it with ViewContainerRef
and for that to work you might need to add providers
to use it as a singleton
When using AngularUtilService, you might need to add it in your providers
list
createAngularComponentAppendToDom
signature change (starting from v6.3.0
)
Also in the same AngularUtilService
, the method signature arguments createAngularComponentAppendToDom
changed slightly, the 3rd argument was previously clearTargetContent
, to match the signature of createAngularComponent
, but is now replaced by data
so that you can provide data to the new Component instance. The clearTargetContent
was dropped because it is no longer needed since we should always replace the entire html content and that is now the default.
The new signature, in v6.3.0
, for both createAngularComponent
and createAngularComponentAppendToDom
is now the following:
replaced multiple-select
with multiple-select-vanilla
multiple-select
with multiple-select-vanilla
This change was required because the previous library was a jQuery based lib, so I rewrote the lib as a new native lib to drop jQuery. However with this change, there were a couple of options that were dropped and/or modified.
The new lib also offers a bunch of new options as well, you can see the full interface at MultipleSelectOption
Slickgrid-Universal
If you use any of the Slickgrid-Universal extra dependencies then make sure to upgrade them to the new major 3.0.0
version so that they work with Angular-Slickgrid 6.0.0
angular.json
config
angular.json
configSince we dropped jQuery, you can also remove it from your angular.json
list of scripts as well and anywhere else that might be referencing it. Also the multiple-select-modified
now uses SASS and is now imported directly in Slickgrid-Universal, so CSS imports are no longer needed
Editor/Filter params
should be using editorOptions
/filterOptions
params
should be using editorOptions
/filterOptions
For better TypeScript support, we now recommend to use either editorOptions
or filterOptions
depending if it's an Editor or a Filter.
Final Note
and that's about it, the migration is relatively simple as you can see :)
File Size Comparisons
While comparing with the folder properties with "size on disk" on Windows, we're averaging 4-5% smaller size in our new release by removing jQuery with this new release.
Last updated