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:
| Name | Type | Default | Description |
|---|---|---|---|
| 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:
| Name | Type | Description |
|---|---|---|
| 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. |