Attributes

The CLUSTER element has the following attributes:

Table 1. Attributes of the CLUSTER Element

Attribute Name

Required

Default

Description

TITLE

No

 

A reference to an externalized string containing the title string for this cluster.

NUM_COLS

No

1

The number of columns to display in the cluster (a cluster column includes both the label and field).

TAB_ORDER

No

COLUMN

Indicates the order to layout elements in a multi-column cluster. The elements can be ordered by ROW or COLUMN (default). Please note, if a CLUSTER has NUM_COLS set to 2 or above and is going to contain a mix of LIST and FIELD elements, the TAB_ORDER must be set to ROW.

SHOW_LABELS

No

true

Can be set to true (the default) to show labels beside the field values or false to show no labels at all.

LAYOUT_ORDER

No

LABEL

Labels can be displayed to the left or to the right of their associated fields. Set the attribute value to LABEL to show labels to the left (this is the default behavior). Set the attribute value to FIELD to show labels to the right.

WIDTH

No

100

The percentage of the width of the containing area that the cluster should occupy.

STYLE

No

 

The class name of the CSS style to associate with this cluster for formatting.

DESCRIPTION

No

 

A reference to an externalized string that provides more details about the cluster than the title alone. This will be displayed below the title on the page.

LABEL_WIDTH

No

 

The percentage of the width of a cluster column that the label should occupy. By default, the web browser will determine the widths as appropriate.

This attribute has an effect even if SHOW_LABELS is set to false. It is possible, say, to use action controls in place of text labels. You might want to control the width of these action control columns and you can do that by setting the LABEL_WIDTH attribute. The specified width will be applied to every other column. Whether this starts with the first or second column depends on the LAYOUT_ORDER attribute.

The LABEL_WIDTH attribute will not apply to codetable hierarchy fields when SHOW_LABELS is set to false or the FIELD attribute CONFIG has a value of CT_DISPLAY_LABELS. See the CONFIG attribute in FIELD for more information on code table hierarchies.

BEHAVIOR

No

EXPANDED

Collapsible clusters can be initially displayed expanded or collapsed on a page. Set the attribute value to EXPANDED to display a collapsible cluster fully expanded. Set the attribute to COLLAPSED to display a collapsible cluster collapsed. To remove the collapsible functionality from a cluster set the attribute to NONE. Note that this attribute is only applicable when the property ENABLE_COLLAPSIBLE_CLUSTERS is not set or is set to true in curam_config.xml. For details see General Configuration. This feature is currently not supported on clusters containing Charts, Evidence Review Widgets, Evidence Comparison Widgets, or Evidence Tab Containers.

SUMMARY

No

 

A reference to an externalized string containing the summary of this cluster. The SUMMARY attribute describes the purpose and/or structure of a cluster.

SCROLL_HEIGHT

No

 

Specifies in pixels the desired maximum height of a scrollable cluster.