Interaction guide

Edit data grid documentation

Editing turns the grid from a reader into an editor. This page focuses on enabling edits cleanly and reacting to user changes without breaking grid state.

What it means

Editing turns the grid into the place where users change data, not just view it. The main job here is making edits feel immediate and safe.

When to use it

Use inline editing on worklists, planning views, and operational screens where the grid is the main editing surface. Prefer read-only grids on reporting screens where direct edits would be surprising or too easy to trigger by mistake.

Implementation notes

Keep edit handlers close to the owning state so the grid reflects committed changes right away. If edits can fail, decide early whether the grid should block, revert, or save optimistically and then validate.

Relevant API

Start with edit.isCellEditing, edit.onCellChange, edit.applySelectionFillRequest, edit.onRowAdd, edit.onRowDelete. Open the live API reference for types and defaults.