Row Categorization

Row Categorization

Categorizes a data table where the values in one or more columns is sorted. This allows all of the rows with the same value in a column to be grouped under a category row labelled with a twistie and a value. The category is initially shown collapsed. Click the twisties to expand the category showing the rows it contains.

Component at design time

Click
Add column to categorize table rows on the Display options tab of the <hx:dataTableEx> component or <h:dataTable> component.

Properties and All Attributes views

The Properties view for a component shows the most common set of attributes you can set on a component, and, depending on the component, you might also see options for adding controls, actions, or other components. To open the Properties view, click

Window | Show View | Properties.

These common attributes for the Row categorization component display on the hx:dataIterator and Styles tabs in the Properties view. See the Row categorization attributes table for a list of attributes.

The All Attributes view shows a table of all the attributes you can set on a component, which includes those attributes you can access from the Properties view. To switch to the All Attributes view, click the
All Attributes icon in the upper right corner of the Properties view.

Table 1. Row categorization attributes

Attribute name

Description

alt

Specifies alternate text for a component. The alternative text is displayed when the element cannot be rendered normally, for example, in browsers that do not support forms and in browsers set to not display images.

binding

An expression that binds the component's instance (usually a user interface component) to a bean property (usually in the backing file).

collapsed

Specifies the initial collapse state of the category row. Values can be true or false. If left blank, the default is true.

collapsedImage

Specifies a custom image to be displayed when a category is collapsed.

expandedImage

Specifies a custom image to be displayed when a category is expanded.

id

Assigns a name to a component. Should be a unique name within a JSP.

rendered

Can be set to true or false:

false - Component will not be rendered to the browser at runtime.

true - Component will get rendered. This is the default value.

style

Specifies CSS style information for the component (for example, style="font-size : 8pt ; color : red"). Defines the properties (such as font and color) of the selected component. This may be done manually, or by clicking the button and selecting the desired properties from within the window.

styleClass

Space-separated list of CSS style classes to be applied when this element is rendered. This value must be passed through as the class attribute on generated markup. Defines the classes (such as style sheets) of the selected component. This may be done manually, or by clicking the button and selecting the desired Classes from within the window.

tabindex

Specifies the position of the component in the tabbing order in the JSP. This value must be a number between 0 and 32767.

value

Specifies the initial text value for the component displayed at runtime. Contains information to be displayed, in the form of a specified value or a pointer to a dynamic value.

Attribute name	Description
alt	Specifies alternate text for a component. The alternative text is displayed when the element cannot be rendered normally, for example, in browsers that do not support forms and in browsers set to not display images.
binding	An expression that binds the component's instance (usually a user interface component) to a bean property (usually in the backing file).
collapsed	Specifies the initial collapse state of the category row. Values can be true or false. If left blank, the default is true.
collapsedImage	Specifies a custom image to be displayed when a category is collapsed.
expandedImage	Specifies a custom image to be displayed when a category is expanded.
id	Assigns a name to a component. Should be a unique name within a JSP.
rendered	Can be set to true or false: false - Component will not be rendered to the browser at runtime. true - Component will get rendered. This is the default value.
style	Specifies CSS style information for the component (for example, style="font-size : 8pt ; color : red"). Defines the properties (such as font and color) of the selected component. This may be done manually, or by clicking the button and selecting the desired properties from within the window.
styleClass	Space-separated list of CSS style classes to be applied when this element is rendered. This value must be passed through as the class attribute on generated markup. Defines the classes (such as style sheets) of the selected component. This may be done manually, or by clicking the button and selecting the desired Classes from within the window.
tabindex	Specifies the position of the component in the tabbing order in the JSP. This value must be a number between 0 and 32767.
value	Specifies the initial text value for the component displayed at runtime. Contains information to be displayed, in the form of a specified value or a pointer to a dynamic value.