RCUI Document Version 5.3.0 for Oracle® Fusion Middleware 11g Release 1 Patch Set 1 (220.127.116.11.0)
Last Updated 08-Dec-2010
The treeTable component displays a tree hierarchy within a tabular layout, allowing concurrent display of multiple objects and associated details.
Note: Images in this guideline are provided as a general reference, and may not be exact representations of FusionFX pages.
Related ADF Elements
Refer to the ADF Faces Rich Client demos page to find demos and tag documentation for ADF elements related to this component.
Purpose: The treeTable (Hierarchy Grid) component is primarily used to display hierarchies of homogeneous objects in a tree, together with columns of object attributes in tabular format.
The Tree Table is based on the table component, but displays a list of object names within a Tree, rather than as a flat list.
The treeTable component features elements in common with tables and with Tree components. The following sections provide links to specific sections of the Table and Tree guidelines, and details for elements with distinctive behaviors.
Tree Table Elements
Truncation: The following sub-components of the treeTable component support automatic Resize truncation when text extends beyond the container, or when a user resizes the column or row so that its width is less than that of the text string: tree columns, row and column headers, and tree text. See the Truncation section of the Headers guideline for details.
Note that when a tree is set into a treeTable component it will truncate automatically, but the tree component itself doesn't support truncation.
The Tree column displays a hierarchy in a tree layout, just as a regular Tree component. The tree interaction is identical to that of a Tree component (See the Tree guideline). The column interaction is the same as a table's object column (see Table Elements guideline), except that:
Note that the Tree column can be wrapped, resized, reordered, sorted, banded, and bordered, just as other columns.
Tree Tables share the following elements that are used in Trees but not in tables . All links in the following list point to the Tree guideline:
Note: The only Tree element not used in a Tree Table is the Tree Region. The equivalent element in a Tree Table is the Tree column.
Same as Title Area in the Table Elements guideline.
Same as Cells in the Table Elements guideline.
Same as Columns in the Table Elements guideline.
Same as Rows in the Table Elements guideline except that Tree Table rows do not support sequential numbering of row headers.
Same as Node Icons in the Tree guideline.
Tree Tables can contain multiple columns of status icons, and a single status icon next to each node in the tree.
Same as Help Text in the Table Elements guideline.
Same as Active Data in the Table Elements guideline.
Tree Tables may include a menu bar with commands for performing actions on both tables and trees. The rules for enabling each command are identical to those for the Table and Tree components (see the Table Elements and Tree guidelines). Common items in each Tree Table menu are listed in the following subsections, along with the related component.
The object-specific actions Menu may include a mix of Tree and table commands:
Note: Object-specific actions are not provided as part of the ADF Tree Table component, and must instead be implemented by product teams.
The View Menu includes a mix of Tree and Table commands:
All View menu items listed above are implemented by default. Product teams may disable any of these commands along with any associated direct manipulation actions, if it is necessary to restrict users from modifying the view of the Tree Table.
Note: Node reorder functionality is not a built-in feature of the treeTable component, but can be implemented by product teams. See the Reorder action in the Tree guideline for details.
The Tree Table Format menu is functionally the same as the table Format menu. Typical menu items include:
The menu items listed above are implemented by default. Product teams may disable any of these commands along with any associated direct manipulation actions, if it is necessary to restrict users from modifying the format of the Tree Table.
Tree Tables support sorting as in tables, but with the following restrictions:
Sorting a Tree Table
Note: ADF only supports ADFm-based (data binding) tree tables. For tree tables not based on ADFm, product teams must implement custom tree model sort APIs and sorting logic.
As in tables, context menus display all commands available for a row or column. The key difference in a Tree Table is that row context menus may include Object and View menu commands to manipulate the tree, such as Expand and Expand All Below, and Increase Indent/Decrease Indent. See the related component for rules on enabling each menu item.
Tree Table toolbars may also include a combination of commands from table and tree components.
Same as Actions Column in the Table Elements guideline.
Same as Status Bar in the Table Elements guideline, except: it is not recommended to use the "Rows Selected" status when the Tree Table contains heterogeneous objects or when only the root nodes or only the child nodes may be acted upon. Rendering the "Rows Selected" status in those cases may be confusing to users because the number of rows selected may not be the number of rows that will be acted upon.
Same as Scroll Bars in the Table Elements guideline.