NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2023 most downloaded on pub.dev
A data grid that can be controlled by the keyboard on desktop and web. Of course, it works well on Android and IOS. (DataGrid, DataTable, Data Grid, Data Table, Sticky)
Latest stable
2.4.0
Last release 22 days ago
31 Oct 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 26 of 27 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
27 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Feature: Added multi-column sorting support with priority indicators. Enable via TrinaGridConfiguration.enableMultiColumnSort to allow Shift+Click and
TrinaGridConfiguration.enableMultiColumnSort to allow Shift+Click and Ctrl+Click on column headers to build compound sort hierarchies. Column headers display numbered badges showing their priority when multiple columns are sorted. Supports programmatic multi-sorting via sortAscending(column, append: true), sortDescending(column, append: true), clearSorting(), and server-side multi-sorting through request.sortedColumns on TrinaLazyPagination and TrinaInfinityScrollRows. Columns that set sort in their constructors are ranked in column order, after any that set sortPriority themselves (#436, #441). @lschaffer @doonfrsTrinaAutoSizeMode.fitContent column auto size mode. It sizes each column to the widest value it holds (title, values and the filter field) and shares any leftover width so the columns still fill the grid. Unlike scale it never shrinks a column below its content, so a grid wider than the viewport scrolls instead of collapsing every column to its minimum. TrinaGridColumnSizeConfig.minFitContentWidth and maxFitContentWidth bound the fit, and refitOnRowsChanged (default true) measures again when the rows are replaced, for example on a page change. Columns with a renderer keep their minWidth as the floor, since the drawn width cannot be measured (#415, #416). @doonfrsTrinaGridLocaleText.sidebarSearchHint, sidebarSelectRowPrompt and sidebarNoMatchingFields, translated in every built-in locale. sidebarNoMatchingFields takes a {query} placeholder so each language controls its own word order (#413, #421). @JonathanAJ @doonfrsTrinaGridLocaleText.filterIsEmpty, filterIsNotEmpty and filterRegex, instead of always showing English (#426). @VZahidkoshadcn_ui is now allowed from 0.55 up to (not including) 0.58, with CI covering both ends of the range (#443). @miakhtitleRenderer is the column header renderer (#410, #445). @doonfrsTrinaGridStyleConfig.unfocusedSelectionColor set, the whole current row now keeps that color when the grid loses focus, for example when the user moves to a form field next to it. Only the current cell kept it and the rest of the row went back to its normal color, so it was hard to see which row was selected. Selected rows in row selecting mode switch to it too, like selected cells already did. Grids without unfocusedSelectionColor are unchanged (#303). @doonfrstap / enterText) left the filter unfocused and needed a second tap before typing. Applies to the default filter and to TrinaFilterColumnWidgetDelegate.builder filters (#437). @charlesb9292 @doonfrsTrinaFilterTypeDoesNotContain) and Not equals (TrinaFilterTypeNotEquals) filter types, offered by default and translated in every built-in locale (filterDoesNotContain, filterNotEquals). They exclude exactly the rows their positive type matches, so a number is excluded by its formatted or its raw value, and over all columns a row is kept only when no column matches. Extend TrinaNegatedFilterType to negate other filter types (#432). @lschaffer @doonfrsTrinaGridStyleConfig.columnBackgroundColor fills the whole column header area across the full grid width. Colored column titles left the band at the end of the header, which the header and rows reserve for the vertical scrollbar so they scroll to the same end, in the grid background color, and the same for the space after the last column when the columns are narrower than the grid. The new color fills both and is drawn below the column, group and filter colors. It defaults to null, so existing grids are unchanged (#403, #304, #50). @doonfrsexample/integration_test/ that run the grid in a real desktop app, drive it with real input, assert on the rendered layout and save screenshots. See doc/contributing/e2e-testing.md. @doonfrsMaterial when the host has none of the SDK type, so cell editing and the filter row no longer throw "No Material widget found" in apps on the standalone material_ui package (Flutter 3.47), whose Material is a different type. Grids that already sit under a Scaffold or Material are unchanged. The themes doc now covers using the grid from a material_ui app (#423). @doonfrs @ricardordractivatedBorderColor and was covered by the activated border on the end edge otherwise. The activated border is now drawn inside the divider and above the cell content, so it also shows over renderers that fill the cell with cellPadding: EdgeInsets.zero (#425). @FrankenApps @doonfrsautoFitColumn (and the Auto fit column menu item) and the TrinaAutoSizeMode.fitContent column auto size mode now measure text with the ambient TextScaler. The cells and titles are drawn with it, so under a text scale other than 1 (e.g. desktop font scaling or accessibility font sizes) the fitted columns came out too narrow and cut their values off (#428). @doonfrs @nagylzsContains, Equals, StartsWith, EndsWith and Regex reuse their compiled RegExp instead of compiling one per cell; number-family columns format a num without converting it to a string and parsing it back, and reuse the pattern that strips a formatted value. On 150,000 cells (host JIT) an all-columns Contains predicate over 18 text columns went from 470 ms to 348 ms, currency cell initialization from 164 ms to 142 ms and applyFormat of a num from 81 ms to 45 ms. Results are unchanged. @jan-sirokybool but renders trueText / falseText (Yes / No by default), while the filter only ever compared against true / false, so typing the visible text matched nothing. Both representations now match, and the raw true / false keeps working. Reported through #414. @doonfrs @Baghdady92TrinaFilterColumnWidgetDelegate.booleanSelect() renders an ALL / true / false dropdown that labels its options with the column's trueText / falseText, and .multiSelect(...) renders a checkbox dropdown with a Select all toggle that re-filters live on every change. Defaults are untouched: a column keeps its text filter unless one of the new delegates is set. The ALL and Select all labels are localizable via TrinaGridLocaleText.filterAll / filterSelectAll. @Baghdady92TrinaGridChangeColumnFilterEvent can now replace the filter type of an existing filter row for the column, not just its value, through the new updateFilterType flag. The dropdown filter widgets set it, so a row previously created with another type (e.g. Contains through the filter popup or setColumnFilter) stops comparing with the old semantics. It defaults to false, so typing in the filter text field still keeps the type the user picked in the filter popup. @Baghdady92 @doonfrsTrinaGridConfiguration.fromTheme(context) and TrinaGridStyleConfig.fromTheme/fromColorScheme, deriving the grid colors from the app's Material ColorScheme so the grid follows the host theme and its brightness. Opt-in: the existing light and dark palettes are unchanged (#336). @doonfrs @stan-at-workTrinaGridStyleConfig.copyWith no longer drops rowCheckedColor, rowHoveredColor, enableRowHoverColor and cellDefaultColor. It rebuilt the style through the public light/dark constructors, which do not accept those fields, so any customized value silently reverted to the default. These are now also settable through copyWith, along with cellDirtyColor, frozenRowColor and frozenRowBorderColor. @doonfrscheckReadOnly to TrinaRow and TrinaCell, so read-only conditions can be declared per row or per cell instead of only per column. The first callback that is set wins: cell, then row, then column, then the static TrinaColumn.readOnly (#404). @doonfrsstateManager.refreshReadOnly() to re-evaluate the read-only styling of the cells on screen. Read-only enforcement was already live, but the styling is memoized per cell and could go stale when a checkReadOnly callback depended on state outside its row (#404). @doonfrscheckReadOnly. It only read the static TrinaColumn.readOnly, so it let users edit fields the grid itself blocked (#404). @doonfrssetRowHeight and resetRowHeight no longer drop the row metadata when rebuilding the row. @doonfrshorizontalScrollPhysics and verticalScrollPhysics to TrinaGrid, so each scroll axis can have its own ScrollPhysics. Pair verticalScrollPhysics: NeverScrollableScrollPhysics() with fitContent: true to place a grid inside a scrolling page while keeping its horizontal scrolling (#270). @doonfrsscrollPhysics now takes effect when it changes after the grid is built. TrinaScrollBehavior did not override ScrollBehavior.shouldNotify, so scrollables kept the physics they resolved on their first build. @doonfrsfitContent now accounts for the horizontal scrollbar strip, which is a sibling of the rows viewport rather than an overlay. The grid used to come up short by that strip, leaving the rows scrollable by a few pixels. @doonfrsTrinaGrid.onSelected doc comment and the row selection doc now say when onSelected fires. The comment said it only worked in TrinaGridMode.select, but it also fires in multiSelect, selectWithOneTap and the normal mode with TrinaGridSelectingMode.row. Added end to end and widget tests for the normal mode with row selection (#46). @doonfrsYour coding agent can read these notes before it upgrades. Set up the MCP server →
Feature: Added built-in record sidebar with docked and floating modes (#396). @doonfrs
unfocusedSelectionColor to TrinaGridStyleConfig for visually distinguishing focused vs. unfocused grids in multi-grid layouts (#372). @vasco-feltrinunfocusedSelectionColor now also applies to multi-cell selections (not just the current cell), and falls back to gridBackgroundColor when unset so existing apps see no behavior change. Dark theme ships with a sensible default. @doonfrsFeature: Added TrinaGrid.fitContent to auto-size grid to its rows (#218). @doonfrs
Fix: Remove unused import in trina_smooth_list_view.dart. @doonfrs
Feature: Added metadata support for rows, cells, and columns (#300). @JoshTechLee
Feature: Added scroll physics configuration to TrinaGrid (#262). @doonfrs
Breaking Change: Enhanced rowWrapper callback to include TrinaRow data parameter and renamed row widget parameter to rowWidget for clarity. @doonfrs
Nothing published for this version
Feature: Enhanced filter color customization system. @doonfrs
Feature: Added new popup cells editing widget, including TrinaSelectMenu, TrinaTimePicker, and TrinaPopup. @DMouayad
Revert Merge cell feature and add it to private branch. ( by @doonfrs )
fix: can't start editing while pressing SHIFT key ( by @DMouayad )
fix: show_column_menu in scaled screens ( by @WagDevX )
Fix text input bug where the first character is replaced when typing the second character ( by @doonfrs )
Fix focus issue when header is a TextField or TextFormField ( by @doonfrs )
Introduce date time column type, add example & documentation ( by @doonfrs )
Fix lazy pagination rebuild issue for simple pagination & refresh
Add PDF export functionality with customizable options
TrinaGridExportPdfSettings class.Use dynamic for column menu delegate, instead of String, update the documentation
Include current row with currentSelectedRows list in case of grid selection mode is row.
Enhance Export, fix bug with visible columns
Fix scrollbar drag performance issue
Refactor scrollbars to be more efficient, support more styling & draggable, add example & documentation
Introduce Change Tracking feature
Enhance the pluto grid migration script
Added cell validator for plutoColumn & onValidationFailed for TrinaGrid
Added cell-level renderer support with TrinaCellRenderer
One column per month.