Table style attributes

Table style presentation attributes apply to a table element.

Note: This topic lists presentation style attributes for a specific class of form element, common presentation style attributes can also be used for this type of element.
Table 1. Table style attributes
Attribute GDC GWC-JS GMA GMI
allowWebSelection

Users need to be select items from a table. Once selected, the keyboard shortcut for copying data can be used to copy the selection.

Values can be "yes" or "no" (default).

When allowWebSelection="no", items selection requires the user to hold down the CTRL key while dragging over the selection with the mouse.

When allowWebSelection="yes", item selection requires a mouse drag only. There is no need to press the CTRL key. However, the ability to drag-and-drop data is disabled.

No Yes No No
forceDefaultSettings

By default, tables are reopened with column positions, visibility and sizes they had when the window was closed. By setting this attribute to true, the saved settings are ignored and the table gets the initial column layout. Note that the saved settings include also the sort columns, that will impact on the order of the rows in the table.

Values can be "yes" or "no" (default).

Yes No No No
headerAlignment

Defines the column header alignment in a table.

Values can be:
  • "default" (default): will use the system default. In most case it is left aligned.
  • "left" will force all column headers to be left aligned.
  • "center" will force all column headers to be centered.
  • "right" will force all column headers to be right aligned.
  • "auto" will first try to align each column header according to the "justify" attribute of the column. If no "justify" attribute is set, the column header will be aligned according to the type of data: right for numeric data, left for text data.
Yes Yes No No
headerHidden

Defines if the horizontal header must be visible in a table.

Values can be "yes" or "no" (default).

Yes Yes No No
highlightColor

Defines the highlight color of rows for the table, used for selected rows.

For possible values, see Colors.

Yes Yes No No
highlightCurrentCell

Indicates if the current cell must be highlighted in a table.

Values can be "yes" or "no" (default).

By default the current edit cell in table has a white background. You can change this behavior by setting this attribute to "yes", to use the same color as when highlightCurrentRow is used. Only some type of cells, checkboxes for example, can be highlighted. Normal editor cells stay in white, because this is the editor background color.

Yes Yes No No
highlightCurrentRow

Indicates if the current row must be highlighted in a table during an INPUT ARRAY.

Values can be "yes" or "no" (default).

By default, when a table is in read-only mode (DISPLAY ARRAY), the front-end automatically highlights the current row. But in editable mode (INPUT ARRAY), no row highlighting is done by default. You can change this behavior by setting this attribute to "yes".

Yes Yes No No
highlightTextColor

Defines the highlighted text color of rows for the table, used for selected rows.

For possible values, see Colors.

Yes Yes No No
leftFrozenColumns

Requires "tableType" set to "frozenTable".

Defines how many columns are frozen, starting from the left of the Table.

Values can be any numeric value matching with the number of columns.

Default is "0".

Yes Yes No No
resizeFillsEmptySpace

Defines if the resize of the table adapts the size of the last column to avoid unused space.

Values can be "yes" or "no" (default).

Yes No No No
rightFrozenColumns

Requires "tableType" set to "frozenTable".

Defines how many columns are frozen, starting from the right of the Table.

Values can be any numeric value matching with the number of columns.

Default is "0".

Yes Yes No No
showGrid

Indicates if the grid lines must be visible in a table.

Values can be "yes" (default with INPUT ARRAY) or "no" (default with DISPLAY ARRAY).

By default, when a table is editable (i.e., when controlled by an INPUT ARRAY), the front-end displays grid lines in the table. You can change this behavior by setting the showGrid attribute to "no".

By default, when a table is read-only (i.e., when controlled by a DISPLAY ARRAY), the front-end does not display grid lines in the table. You can change this behavior by setting the showGrid attribute to "yes".

Yes Yes No No
summaryLineAlwaysAtBottom

Defines the placement of the summary row containing aggregate fields.

Values can be "yes" or "no" (default).

When set to "yes", the row containing aggregate fields is rendered in the last line of the table.

When set to "no" (default), the row containing aggregate fields is rendered immediately after the values being aggregated.

Yes No No No
tableType

Defines the rendering type of the table.

Values can be:
  • "normal" (default): Regular table rendering.
  • "pictureFlow": The first column of the table will be used to define the list of images to be used in the picture flow.
  • "frozenTable": Users can "freeze" some columns from scrolling, so that they always remain visible. Default frozen columns can be defined with "leftFrozenColumns" and "rightFrozenColumns" attributes.
Yes Yes No No