Version 22.1 Developer Release Note

Summary

AdapTable 22.1 was released in April 2026 and supports AG Grid version 35.2
It extends Layouts by adding row selection, and contains enhancements to UI Wizards

AdapTable 22.1 is a minor version release which supports AG Grid version 35.2.

The main area of focus in 22.1 is adding Row Selection to Layouts.

It also contains improvements to UI wizards and various bug fixes.

Breaking Change

There are no Breaking Changes in AdapTable 22.1

Layout Row Selection

AdapTable 22.1 introduces powerful Row Selection capabilities as an additional section in Layouts.

This is done via a new RowSelection property in the Layout object.

Note

This property is available in both Table Layouts and Pivot Layouts

There are 3 options when setting the RowSelection property in an AdapTable Layout:

Value	Description	Use `gridOptions`
`undefined`	Layout has no influence over row selection	✅
`false`	Enforces no row selection in the Grid	❌
`LayoutRowSelection` object	Use only the props in this object for selection	❌

Deep Dive

Layout Selection object and AG Grid property equivalents

The LayoutRowSelection object is defined as follows:

Property	Description	Default
Checkboxes	Whether to display checkboxes in Selection Column	true
CheckboxInGroupColumn	Renders selection checkboxes in Auto-Group Column (if `true`) or in dedicated Selection Column (if `false`)	false
EnableClickSelection	Selection behaviour when clicking a row: 'enableSelection' \| 'enableDeselection' \| true \| false	false
GroupSelectMode	Grouping Select Mode: 'self' \| 'descendants' \| 'filteredDescendants'	'self'
HeaderCheckbox	Whether to show checkbox in Header of Selection Column Header ('multiRow' only)	true
Mode	Row Selection Mode: 'singleRow' or 'multiRow'
SelectAllMode	Select All Mode: 'all' \| 'filtered' \| 'currentPage'	'all'

The properties in the LayoutRowSelection object all have equivalents in the AG Grid rowSelection object:

Property	AG Grid Equivalent	Is AG Grid object
`Mode`	`mode`	❌
`Checkboxes`	`checkboxes`	❌
`CheckboxInGroupColumn`	`checkboxLocation`	❌
`GroupSelectMode`	`groupSelects`	✅
`SelectAllMode`	`selectAll`	✅
`HeaderCheckbox`	`headerCheckbox`	❌
`EnableClickSelection`	`enableClickSelection`	✅

Selection Column

AdapTable now provides first-class support for the Selection Column generated automatically by AG Grid.

Users can decide whether the Column should display cell checkboxes, a header checkbox or both.

Note

If neither are set to render, the Column itself is not created by AG Grid

By default the Selection Column will be placed first in the Grid (and doesn't need to be explicitly referenced).

However it is possible to explicitly specify the position of the Selection Column in the Layout (or to configuring pinning and sizing).

Hint

This requires referencing the Selection Column in the Layout using the AG Grid Id of 'ag-Grid-SelectionColumn'

{
  Name: 'Table Layout',
  TableColumns: ['ag-Grid-SelectionColumn', 'make', 'model', 'id', 'year', 'price'],
  RowSelection: {
    Mode: 'multiRow',
    Checkboxes: true,
    HeaderCheckbox: true,
    CheckboxInGroupColumn: true,
    GroupSelectMode: 'descendants',
  },
  ColumnPinning: {
    'ag-Grid-SelectionColumn': 'left',
  },
  ColumnSizing: {
    'ag-Grid-SelectionColumn': {Width: 200},
  },
}

Row Click Behaviour

In addition to selection via checkboxes in the Selection Column, its also possible to configure selection by clicking anywhere in the Row.

This is done via the EnableClickSelection property (identical to AG Grid enableClickSelection).

There are 4 options available:

Property Value	Behaviour
`enableSelection`	Allows selection of a Row by clicking the row itself
`enableDeselection`	Allows deselection of a Row by CTRL-clicking the row itself
`true`	Allows both selection of a row by clicking & deselection of a row by CTRL-clicking
`false`	Prevents rows from being selected or deselected by clicking

UI Improvements

UI Wizards have been improved to be more usable and intuitive
It is now possible to Highlight Columns programatically, using 2 new functions in Grid API: highlightColumn and unHighlightColumn

Change Log

Key	Type	Description
AT-3323	Bug	✅ NonBlanks and Blanks return same result in Filters for array columns
AT-3320	Enhancement	✅ Better handle allowedAggFuncs for AdapTable provided aggregations
AT-3313	Bug	✅ Gradients with Min/Max dont work if undefined values in Column
AT-3310	Bug	✅ Reload initial state API method doesn't persist the provided state
AT-3309	Enhancement	✅ Add Row Selection capabilities to Layouts
AT-3302	Enhancement	✅ Improve UX of Id and Name steps in Calc Colum Wizard
AT-3300	Enhancement	✅ Add search facility in all wizards where we list columns
AT-3299	Enhancement	✅ Put name of Module in each Wizard
AT-3298	Enhancement	✅ Better distinguish between Columns with same name in Wizards
AT-3297	Bug	✅ Condition gets removed when editing Format Columns or Alerts
AT-3296	Bug	✅ AutoGroup Column displays raw values in ColumnFilter IN values
AT-3293	Bug	✅ Custom Column caption reverts when resizing a column
AT-3289	Bug	✅ Column Model is stale after setAdaptableStateKey with new config
AT-3288	Enhancement	✅ Extend Edit Display values to Row Forms
AT-3285	Bug	✅ PivotResultColumns with underscore break if Total is enabled
AT-3279	Task	✅ Refactor and update the 'ipushpull' plugin
AT-3274	Enhancement	✅ Hide Plus Minus and Cell Summary Modules if cell selection turned off
AT-3260	Task	✅ Replace react-beautiful-dnd with custom implementation
AT-3232	Enhancement	✅ Extend highlighting to Columns
AT-3114	Enhancement	✅ Add support for Excel Column Types

Version 22.1 Developer Release Note

Summary

Breaking Change

Layout Row Selection

Note

Deep Dive

Layout Selection object and AG Grid property equivalents

Selection Column

Note

Hint

Row Click Behaviour

UI Improvements

Change Log

AdapTable Resources