DetailCellRendererParams

Master-Detail parameters for nested Grid rendering. Configures detail grid appearance, data binding mode, and lifecycle events. Supports three data binding modes:

  • Mode 1: Nested Data (child property in parent row)
  • Mode 2: Mapping Data (separate child dataset filtered by foreign key)
  • Mode 3: Async (callback-based dynamic data loading)

Props

The following table outlines the props for the DetailCellRendererParams:

NameTypeDefaultDescription
childDataSource
CT[] | DataManager | DataResult
undefined

Child dataset for Mapping Data mode. Complete array of potential child rows to filter by mappingID. Only applicable when mappingID is specified.

detailGridOptions
-

Detail grid configuration object. Specifies columns, height, paging, and recursive nesting setup.

getDetailRowData
(params: GetDetailRowDataParams<T, CT>) => void | Promise<void>
-

Callback function to retrieve or compute child row data. Supports all three data binding modes: Nested Data, Mapping Data, and Async. Called when detail row is expanded and must provide child data. Implementation must call either successCallback or failCallback.

mappingID
string
undefined

Parent key field name for Mapping Data mode. Specifies which parent row property contains the foreign key value. Used to filter childDataSource by this key. Only applicable when childDataSource is provided.

Events

The following table outlines the events for the DetailCellRendererParams:

NameTypeDescription
onDetailGridCreated
(gridRef: DetailGridRef) => void

Fires when detail grid instance is created and rendered. Called after detail grid DOM elements are mounted. Use for initializing detail grid state or side effects.

onDetailGridDestroyed
(gridRef: DetailGridRef) => void

Fires when detail grid instance is destroyed and removed. Called when detail row is collapsed or parent row is removed. Use for cleanup: timers, event listeners, resources.