What's New in AG Grid 31

  |   Releases
Animation: 'What's New in AG Grid 31' banner demoing initial state save and restore, with framework logos

AG Grid 31 is an important major version, which adds many new features across the grid together with improvements to developer experience, theming, accessibility and performance:

1. Save/Restore the initial grid state as a single object
2. New Quartz Theme
3. Accessibility - Column Header resizing and moving via keyboard
4. Prevent Group Column Reordering and Removal
5. Pagination Panel Page Size Selector

Please note that AG Grid 31 has breaking changes from AG Grid 30.X. We're providing Codemods to help you upgrade by automating the migration process as much as possible. Please review the migration guide when planning to update to this version.

Save and Restore the Initial Grid State

AG Grid 31 allows you to easily save and restore the grid state via a single state object. This single grid state object keeps the state of columns, row selection, group row expanded status, scrollbars, etc. This helps you recreate the grid exactly as the user left it. You can see this documented here and demonstrated below:

Animation: grouping by Athlete, hiding Date, setting page size 50 and expanding a group, then Recreate Grid restores it

New Theme - Quartz and Automatic Switching Light/Dark Themes

AG Grid 31 introduces the Quartz theme, which features updated typography and icons to provide a modern and uncluttered feel.

Also, all grid themes now have an auto version which uses the prefers-color-scheme CSS media feature to switch between dark and light variants depending on whether the user has enabled dark mode on their operating system. Please see this documented here and illustrated below:

Quartz theme grid in light mode with a Country set filter open and the Columns tool panel beside it

Column Header Resizing and Moving via Keyboard

AG Grid 31 improves accessibility support by allowing keyboard users to resize columns via Alt+Left/Right Arrow keys and reorder columns via Shift+Left/Right Arrow keys. There are also many other accessibility-related improvements. See the column resizing and moving documented here and demonstrated below:

Animation: moving header focus with the keyboard and reordering columns, ending with Language moved to the first column

Prevent Group Column Reordering and Removal

AG Grid 31 allows locking Group Columns, which prevents users from ungrouping or reordering group columns via any means a specified number of group columns. Learn more about this new feature here and see it demonstrated below:

Animation: Sport and Year row groups swap places by dragging, while the locked Country group stays first and can't be removed

Pagination Panel Page Size Selector

AG Grid now supports changing the page size directly via a page size selector which is displayed in the pagination panel when Row Pagination is enabled. The page size and current page index are saved by the grid state and can easily be restored as part of the initial state, as shown below. Learn more about this new feature here:

Animation: the pagination panel's page size selector changes from 100 to 50 then 20 rows, then paging on to page 5 of 348

Summary

AG Grid 31 is a milestone version - it includes many end-user features across the grid together with big improvements in developer experience, theming, accessibility and quality.

We suggest reviewing the migration guide when planning to upgrade and seeing the full list of changes in our Changelog.

As always, we’re keen to help you upgrade and to hear your feedback.

Happy coding!

Read more posts about...