Show TOC

 TableColumnLocate this document in the navigation structure

Definition

A Table is built of TableColumns. You have to insert a TableCellEditor into each TableColumn.

Note

As of SAP NetWeaver 7.0 (2004s), the association role of TableColumns has changed from Columns to GroupedColumns. You can migrate tables to the new association role using the Migrate Columns function in the context menu of the Table UI element.

 

Description of Properties
  • accessibilityDescription

    When accessibility is activated, the assigned text is added to the tooltip. This description provides semantic details of the UI element and is only read by the screen reader if the user focuses the complete Ul element.

  • cellDesign

    This specifies the color of the TableColumn. The cellDesignproperty is represented by enumeration type WDTableCellDesign.

    For the enumeration values see: WDTableCellDesign

  • colSelectionState

    This specifies the selection state of the column. This property can be set by the application developer - for example, when the user triggers the onAction event. colSelectionState can have the following values and is represented by enumeration type WDTableColumnSelectionState.

    • notSelectable
    • notSelected
    • selected
  • design

    This property is deprecated. Use cellDesign instead.

  • explanation

    This determines the explanation text. More information: Explanation

  • filterValue

    You can use this property to define the value to be filtered and to bind it to a corresponding context attribute.

  • fixedPosition

    This specifies whether a table column is fixed on the left or right. fixedPosition is represented by enumeration type TableColumnFixedPosition and can have the following values:

    left

    The column is fixed on the left.

    notFixed

    The column is not fixed and can be scrolled.

    right

    The column is fixed on the right.

  • groupingValue

    This specifies the table column that is used to group the values.  The user can identify the grouping by the fact that the same values of a column are only displayed in the column in which they are listed for the first time and by the fact that there is no separator between the cells of the grouped values.

  • hAlign

    This describes the horizontal alignment of the table column. The hAlign property is represented by the enumeration type WDTableColumnHAlign and can have the following values:

    auto

    Automatic alignment of the text content. The alignment is specified by the usage of the UI element - for example, by the data type of the value to be represented.

    beginOfLine

    The text content is always displayed at the beginning of the line. Therefore, the text content for the value ltr of thetextDirection property is left-justified. The text content for the valuertl is right-justified.

    center

    Center alignment.

    endOfLine

    The text content is always displayed at the end of the line. Therefore, the text content for the value ltr of the textDirection property is right-justified. The text content for the value rtl is left-justified.

    forcedLeft

    The text content is always left-justified, regardless of whether the value is ltr or rtl for the textDirection property.

    forcedLRight

    The text content is always right-justified, regardless of whether the value is ltr orrtl for the textDirection property.

    left

    Left-justified alignment. This value is deprecated. Use beginOfLine instead.

    right

    Right-justified alignment. This value is deprecated. Use forcedRight instead.

    The default value for this property is auto .

  • headerTextWrapping

    This specifies whether the header text wraps.

  • isFiltered

    This specifies whether the values of the column are filtered and the filter icon is displayed in the column's header.

  • resizable

    This specifies whether the width of the table column can be modified by the user.

  • selectedCellVariant

    This specifies the selected cell variant.

  • sortState

    This specifies the sort status of the table column. sortState is represented by enumeration type TableColumnSortDirection and can have the following values:

    down

    The table column is sorted in descending order.

    none

    The table column is not sorted, but can be sorted.

    notSortable

    The table column cannot be sorted.

    up

    The table column is sorted in ascending order.

  • visible

    This property specifies the visibility of the UI element. The default value for this property is visible.

    • visible. The UI element is displayed on the screen.
    • none. The UI element is not visible on the screen and takes up no space.
    • notYet. The UI element is not yet visible in its view and is treated like NONE. It can be made visible by personalization. This can be used to ship hidden parts of a screen that can then be made visible on demand.
    • always. A UI element is always visible and cannot be hidden by personalization.
    • blank. The UI element is not visible on the screen but takes up space.
      Note

      This value should not be used for security reasons. Use none instead.

  • width

    This determines the width of the table column. You can specify it in relative CSS units such as em, ex, or percentage.

More information: Common UI Element Properties

Properties Overview

Name

Interface

Type

Initial Value

Bindable

accessibilityDescription

IWDAbstractTableColumn

String

 

bindable

cellDesign

IWDTableColumn

TableCellDesign

standard

bindable

colSelectionState

IWDTableColumn

WDTableColumnSelectionState

notSelectable

bindable

design

IWDTableColumn

CellBackgroundDesign

transparent

bindable

explanation

IWDAbstractTableColumn

String

 

not_bindable

filterValue

IWDTableColumn

String

 

bindable

fixedPosition

IWDAbstractTableColumn

TableColumnFixedPosition

notFixed

bindable

groupingValue

IWDTableColumn

String

 

bindable

hAlign

IWDTableColumn

TableColumnHAlign

auto

bindable

headerTextWrapping

IWDAbstractTableColumn

boolean

false

bindable

isFiltered

IWDTableColumn

boolean

false

bindable

resizable

IWDTableColumn

boolean

true

bindable

selectedCellVariant

IWDTableColumn

String

 

bindable

sortState

IWDTableColumn

TableColumnSortDirection

none

bindable

visible

IWDAbstractTableColumn

Visibility

visible

bindable

width

IWDTableColumn

String (CSS size)

 

bindable

Events
  • onAction (String col)

    This event is deprecated. Use onColSelect or onSort of Table instead