When a Master Row is expanded, the grid uses the default Detail Cell Renderer to create and display the Detail Grid inside one row of the Master Grid. You can provide a customer Detail Cell Renderer to display something else if the default Detail Cell Renderer doesn't do what you want.
Configure the grid to use a customer Detail Cell Renderer using the grid property
The following examples demonstrate minimalist custom Detail Cell Renderer. Note that where a Detail Grid would normally appear, only the message "My Customer Detail" is shown.
Custom Detail With Form
It is not mandatory to display a grid inside the detail section. As you are providing a custom component, there are no restrictions as to what can appear inside the custom component.
This example shows a custom Detail Cell Renderer that uses a form rather than a grid.
Custom Detail With Grid
It is possible to provide a Customer Detail Grid that does a similar job to the default Detail Cell Renderer. This example demonstrates displaying a customer grid as the detail.
In order for the Detail Grid's API to be available via the Master Grid as explained in Accessing Detail Grids, a Grid Info object needs to be registered with the Master Grid.
When the Detail Grid is created, register it via
when the Detail Grid is destroyed, unregister it via
A Detail ID is required when calling these methods. Any unique ID can be used, however for consistency
with how the default Detail Cell Renderer works it's recommended to use the ID of the detail Row Node.
When data is updated in the grid using Transaction Updates, the grid will call refresh on all Detail Cell Renderer's.
It is up to the Detail Cell Renderer whether it wants to act on the refresh or not. If the
refresh() method returns
true, the grid will assume the Detail Cell Renderer has
refreshed successfully and nothing more will happen. However if
false is returned,
the grid will destroy the Detail Cell Renderer and re-create it again.
This pattern is similar to how refresh works for normal grid Cell Renderer's.
The example below shows how components can optionally refresh on updates. The example
refreshes the first row every one second. The
refresh() method gets called on all
Detail Cell Renderers after the transaction is applied. Only the first Detail Cell Renderer
false so it is the only one that updates.
The creation time is printed to each Detail Cell Renderer so it can be noted when it was last created.
In this simple example, it would be possible for the components to just update themselves
and not rely on the grid destroying and re-creating the components. However the example is
contrived to demonstrate returning
false from the