Table style attributes
Table presentation style attributes apply to a TABLE
container.
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.
allowWebSelection
Users need to 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"
, item 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.
alternateRows
Controls background color rendering of odd/even rows.
Values can be "yes"
(default) or "no"
.
This style attribute applies only to classic table/tree rendering, as a set of horizontal rows.
The style system also supports the :odd/:even
pseudo selectors, to define specific rendering for table/tree
rows (not only background color). When :odd
or :even
is used, it
takes precence over the alternateRows
style attribute. This solution is however
expensive in terms of front-end side processing; Consider using alternateRows
instead of :odd/:even
pseudo selectors.
forceDefaultSettings
Values can be "yes"
or "no"
(default).
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.
headerAlignment
Defines the column header alignment in a table.
"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 following theJUSTIFY
attribute of the column. If noJUSTIFY
attribute is set, the column header will be aligned based on the type of data: right for numeric data, left for text data.
headerHidden
Defines if the horizontal header must be visible in a table.
Values can be "yes"
or "no"
(default).
highlightColor
Defines the highlight color of rows for the TABLE
, used for selected rows.
For possible values, see Colors.
For more details see Row and cell highlighting in TABLE.
highlightCurrentCell
Indicates if the current cell is highlighted in a TABLE
, with system default highlight
colors, or the colors defined by the highlightColor
/highlightTextColor
style attributes.
Values can be "yes"
,"no"
(default depends on front-end and dialog
type)
For more details see Row and cell highlighting in TABLE.
highlightCurrentRow
Indicates if the current row is highlighted in a TABLE
, with the system default
highlight colors, or the colors defined by the highlightColor
/
highlightTextColor
style attributes.
Values can be "yes"
or "no"
(default depends on front-end and dialog
type)
For more details see Row and cell highlighting in TABLE.
highlightTextColor
Defines the highlighted text color of rows for the TABLE
, used for selected rows.
For possible values, see Colors.
For more details see Row and cell highlighting in TABLE.
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 the number of columns.
Default is "0"
.
reduceFilter
Controls the usage of a reduce filter, to limit the visible rowset in the list container.
Values can be "yes"
(default on mobile) or "no"
(default on
desktop).
The reduce filter is only available when all data rows are in memory.
For more details see List reduce filter.
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).
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 the number of columns.
Default is "0"
.
rowActionTrigger
Defines the physical event that will fire the row selection action (DOUBLECLICK
) on a table, tree or
scrollgrid row.
"singleClick"
: Physical event is a single click on desktop platforms, and single tap on touchscreen devices."doubleClick"
(default): Physical event is a double click on desktop platforms, and double tap on touchscreen devices.
rowHover
Controls specific background rendering of a row on mouse hover.
Values can be "yes"
(default) or "no"
.
Do not confuse with row/cell highlighting style attributes.
showGrid
Indicates if the vertical and/or horizontal grid lines must be visible in a table.
This style attribute applies only to classic table/tree rendering, as a set of horizontal rows.
-
"yes"
: Show vertical and horizontal lines (this is the default withINPUT ARRAY
) "no"
: Do not show lines (this is the default withDISPLAY ARRAY
)"vertical"
: Show only vertical lines."horizontal"
: Show only horizontal lines.
tableType
Defines the rendering type of the table.
The tableType
style attribute cannot be changed dynamically,
once the widget has been displayed.
"normal"
(default): Regular table rendering."frozenTable"
: Users can "freeze" some columns when scrolling, so that they always remain visible. Default frozen columns can be defined with"leftFrozenColumns"
and"rightFrozenColumns"
attributes."listView"
(deprecated): The table is rendered as a list view with two columns.