CellChangeDetail

Detail for cell-change event (emitted by core after mutation). This is an informational event that fires for ALL data mutations.

Use this event for:

• Logging/auditing changes
• Cascading updates (updating other fields based on a change)
• Syncing changes to external state

Example

grid.on('cell-change', ({ row, rowId, field, oldValue, newValue, source }) => {
  console.log(`${field} changed from ${oldValue} to ${newValue}`);
  console.log(`Change source: ${source}`);

  // Cascade: update total when price changes
  if (source === 'user' && field === 'price') {
    grid.updateRow(rowId, { total: newValue * row.quantity });
  }
});

Properties

Property	Type	Description
row	TRow	The row object (after mutation)
rowId	string	Stable row identifier
rowIndex	number	Current index in rows array
field	string	Field that changed
oldValue	unknown	Value before change
newValue	unknown	Value after change
changes	Partial<TRow>	All changes passed to updateRow/updateRows (for context)
source	UpdateSource	Origin of this change

See Also

• UpdateSource for understanding change origins
• CellCommitDetail for the commit event (editing lifecycle)