Full React Rendering, Row Grouping Enhancements, Columns Tool Panel and Set Filter Improvements, Charts Improvements
What's New Copy
AG Grid 26.0 adds many new features - Full React Rendering, Row Grouping Enhancements, Columns Tool Panel and Set Filter Improvements, Charts series improvements and many more.
Documentation Copy
See AG Grid 26.0 Documentation.
Breaking Changes Copy
- Now when setting / updating Column Definitions, the order of the Columns in the grid will always match the order of the Column Definitions. Prior to v26,
applyColumnDefOrder
was used to achieve this, however this is now the default behaviour. To turn off this behaviour, i.e. to maintain the order of Columns between updates to Column Definitions, set the grid propertymaintainColumnOrder=true
(see Maintain Column Order). - The
AnimationQueueEmptyEvent
has been removed, the grid API methodisAnimationFrameQueueEmpty()
can be used instead. .cjs
are self-contained units preventing LicenseManager from recognizing the license key. These files previously included all AG Grid related dependencies. These files now only contain the relevant code for that module, which is the correct behaviour.- The row auto-height behavior has been changed. When a column uses auto height (
colDef.autoHeight=true
), there is no need to callgridApi.resetRowHeights()
in theonColumnResized
event handler anymore to force the rows to update their row height after a column resize operation, as the grid will automatically resize the rows when it detects a height change. From v26.0 onward, keeping these calls togridApi.resetRowHeights()
causes flicker as rows render themselves twice instead of once. Please remove calls togridApi.resetRowHeights()
inonColumnResized
event handler to avoid flicker in row re-rendering. - Cell Renderers are completely destroyed when editing starts. This is in line with how Components work in frameworks (Angular, React, etc.), that when you take the Component out of the DOM, that is in effect destroying the component. So when editing starts (Cell Editor inserted into the Cell), the Cell Renderer is destroyed.
Integrated Charts Copy
- The previously deprecated
processChartOptions()
callback has now been removed. Please use Theme Based Configuration instead. getChartImageDataURL()
has been removed from theChartModel
and it is now available directly through the grid API (see Downloading Chart Image).- The chart instance has been removed from the
ChartModel
to support serialization. UsegridApi.getChartRef(chartId)
instead (see Accessing Chart Instance).
Standalone Charts Copy
The following Standalone Chart options were previously deprecated and have now been removed:
Chart
tooltipTracking
- removed, usetooltip.tracking
instead.tooltipClass
- removed, usetooltip.class
instead.
Series
tooltipEnabled
- removed, usetooltip.enabled
instead.tooltipRenderer
- removed, usetooltip.renderer
instead.
Legend
layoutHorizontalSpacing
- removed, useitem.paddingX
instead.layoutVerticalSpacing
- removed, useitem.paddingY
instead.itemSpacing
- removed, useitem.marker.padding
instead.markerShape
- removed, useitem.marker.shape
instead.markerSize
- removed, useitem.marker.size
instead.strokeWidth
- removed, useitem.marker.strokeWidth
instead.color
- removed, useitem.label.color
instead.fontStyle
- removed, useitem.label.fontStyle
instead.fontWeight
- removed, useitem.label.fontWeight
instead.fontSize
- removed, useitem.label.fontSize
instead.fontFamily
- removed, useitem.label.fontFamily
instead.
Deprecations Copy
This release includes the following deprecations:
Grid Options Copy
groupMultiAutoColumn
- deprecated, usegroupDisplayType='multipleColumns'
instead.groupUseEntireRow
- deprecated, usegroupDisplayType='groupRows'
instead.groupSuppressAutoColumn
- deprecated, usegroupDisplayType='custom'
instead.defaultGroupSortComparator
- deprecated, usedefaultGroupOrderComparator
instead.
Column Properties Copy
pinnedRowCellRenderer
,pinnedRowCellRendererFramework
, andpinnedRowCellRendererParams
are deprecated. Please usecellRendererSelector
instead if you want a different Cell Renderer / Params for Pinned Rows.
Changes List Copy
If you would like to see the full list of changes in this release, please see the Changelog.