About Detail and DetailDisclosure

You can design tables that have the ability to show or hide additional detail for individual rows.

Table with Details column

Use the detail named child of the table component to specify the node to stamp below each row that is disclosed. When a table uses such a named child, ADF UIX automatically renders an additional column with the heading "Details" and a hideShow component in each cell of that column.

When the user clicks the hideShow component, UIX generates a URL with three parameters:

event (which is set to either 'hide' or 'show')
source (which is the table id)
value (which is the table row that the hideShow component is on)

To add the links "Show All Details" and "Hide All Details" above the table rows, set the table attribute allDetailsEnabled to true. When the user clicks these links, the following parameters are produced:

event (which is set to either 'hide' or 'show')
source (which is the table id)
value (which is UIConstants.VALUE_SHOW_ALL)

The disclosed state (i.e., hidden or disclosed) of each cell in the "Details" column is determined by the detailDisclosure complex attribute. This complex attribute is a DataObjectList attribute on the table component, and it specifies the data source for the list of detail rows currently disclosed.

The DataObjectList should contain one DataObject for each row in the table, each of which is queried with the key "disclosed" when that row is rendered. If this DataObject returns Boolean.TRUE from the query, the row is rendered as disclosed and the contents of the detail child are stamped in a special row under the normal data row.

When the detail child is rendered underneath any disclosed table row, the current data object will be the data object for that table row. Thus, the contents of the detail child can get their bound values from that table row data object by binding to the current object.