[!NOTE] Please note that Angular-Slickgrid (and all other supported frameworks) will soon be moved under the Slickgrid-Universal project. This will happen in the next major version, which is expected by end of April 2025. The installation will remain the same
npm install angular-slickgrid, it's just the project that will be moved into a central location (much easier to maintain).
One of the best JavasSript data grid SlickGrid, which was originally developed by @mleibman, is now available to the React world. SlickGrid beats most other data grids in terms of features, customizability & performance (running smoothly with even a million rows). Slickgrid-React 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 >=v4.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 4+ (... or use the Wikis for older versions).
Available in Stackblitz (Codeflow) below, this can also be used to provide an issue repro.
Refer to the Docs - Quick Start and/or clone the Slickgrid-React-Demos repository. Please consult all documentation before opening new issues, also consider asking installation and/or general questions on Stack Overflow unless you think there's a bug with the library.
npm install slickgrid-reactimport { type Column, type GridOption, SlickgridReact } from 'slickgrid-react';
export default function Example() {
const [columns, setColumns] = useState<Column[]>();
const [options, setOptions] = useState<GridOption>();
const [dataset, setDataset] = useState<any[]>(getData());
useEffect(() => defineGrid());
function defineGrid() {
setColumns([
{ id: 'firstName', name: 'First Name', field: 'firstName', sortable: true },
{ id: 'lastName', name: 'Last Name', field: 'lastName', sortable: true },
{ id: 'age', name: 'Age', field: 'age', type: 'number', sortable: true },
]);
setOptions({ /*...*/ }); // optional grid options
}
function getData() {
return [
{ id: 1, firstName: 'John', lastName: 'Doe', age: 20 },
{ id: 2, firstName: 'Jane', lastName: 'Smith', age: 21 },
];
}
return !options ? null : (
<SlickgridReact gridId="grid1"
columnDefinitions={columns}
gridOptions={options}
dataset={dataset}
/>
);
}This project does not work well with React.StrictMode, so please make sure to disable it to avoid getting mad at the library :P
Note please be aware that only the latest major version of Slickgrid-React will be supported and receive bug fixes (it's already a lot of work to maintain for a single developer like me).
| Slickgrid-React | React version | Migration Guide | Notes |
|---|---|---|---|
| 5.x | React 18+ | Migration 5.x | modern UI / Dark Mode, requires Slickgrid-Universal 5.x |
| 4.x | Migration 4.x | merge SlickGrid into Slickgrid-Universal, requires Slickgrid-Universal 4.x | |
| 3.x | Migration 3.x | removal of jQuery (now uses browser native code), requires Slickgrid-Universal 3.x | |
| 2.x | React 18+ | Migration 2.x | removal of jQueryUI, requires Slickgrid-Universal 2.x version |
Multiple styling themes are available
- Default (UI agnostic)
- Bootstrap (see all Slickgrid-React 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 is often used for live demos, it does work as well with any other UI framework like Bulma, Material, ...
Slickgrid-React 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
For a complete set of working demos (40+ examples), we strongly suggest you to clone the Slickgrid-React Demos repository (instructions are provided inside it). The repo provides multiple examples and are updated every time a new release is out, so it is updated frequently and is used as the GitHub live demo page.
Check out the Releases section for all latest News & Releases.
Slickgrid-Universal has 100% Unit Test Coverage and all Slickgrid-React Examples are tested with Cypress as E2E tests.
You like Slickgrid-React? Be sure to upvote ⭐, and perhaps support me with caffeine ☕ or GitHub sponsoring and feel free to contribute. 👷👷♀️
Thanks to all my sponsors!
