<amc:table>

Tag name: <amc:table>
The Table is used to display tabular data. It also supports sorting, filtering, and record navigation.

The immediate children of a Table component must all be <amc:column> components. Each visible Column component creates a separate column in the Table. For more information see the documentation for <amc:column>

By default, the table draws both horizontal and vertical grid lines.

The Table component supports sorting columns in ascending or descending order. On Windows Mobile, sorting is performed by clicking on the header of the column to be sorted. Repeated clicking will change between ascending and descending sorting. To sort on Blackberry, move focus to a cell within the column to be sorted and select Sort from the menu.

There are three requirements to enable sorting: the underlying table model must support sorting, the "sortProperty" and "sortable" attributes must be set on the column to enable the sort capability for that column.

To support sorting, the CollectionModel instance must implement the following methods:

    public boolean isSortable(String propertyName)
    public void setSortCriteria(List criteria)
    public List getSortCriteria()

To associate a column with a particular property-name to be used for sorting purposes, use the "sortProperty" attribute on the column. To enable the UI for sorting a particular column, set the "sortable" property to true. For more information see the documentation for <amc:column>.

In the following example, both columns are sortable. Sorting the first column sorts by the "firstname" property; sorting the second column sorts by the "lastname" property.

<amc:table ...>
  <amc:column sortProperty="firstname" sortable="true" headerText="Firstname">
    ...
  </amc:column>
  <amc:column sortProperty="lastname" sortable="true" headerText="Lastname">
    ...
  </amc:column>
</amc:table>

The currently selected row is indicated by changing the background of that row to the color specified by the selectedRowColor attribute. Furthermore, the selected cell within the selected row is indicated by setting its background to the color specified by the selectedCellColor attribute.

On non-touchscreen Blackberry smartphones, the table implements three different selection modes: table, row, and cell. By default the table will start out in table mode; however, the starting selection mode can be specified by setting the startingSelectionMode attribute to the desired value. To change from table to row mode and row to cell mode, press the trackwheel/trackball while focus is on the table. To change from cell to row mode and from row to table mode, press the Back button.

In table mode, the entire table acts as one component for purposes of scrolling. In this mode it is not possible to interact with the components within the table nor is it possible to directly navigate through rows and columns.

In row mode, it is possible to navigate through rows and columns directly by using the trackwheel/trackball. However, it is not possible to interact with components within the table. For example, in this mode it is not possible to click on a commandButton that is inside the currently selected cell. User inputs are handled by the table and are not propagated to individual contained components. It is helpful to think of the table and row modes as read-only modes since they make it impossible to directly change the values of the contained components.

In cell mode, it is possible to directly interact with components within the table. For example, in this mode it is possible to click on a commandButton or change the text of an inputText that is inside the currently selected cell. User inputs are handled by the component within the selected cell first before being given to the table. For example, if there are two focusable components within a cell, then scrolling will first move focus from one focusable component to the next before changing the selected row/column.

It is possible to change the current row on the table's underlying iterator by using first/previous/next/last operation bound to components outside the table. When the current row is changed through such means, the table will scroll to keep the newly selected row visible.

Examples of the "width" attribute: width="700" for 700 pixels, or width="100%" to fill up the entire width of the container. If no value is defined then the default will be 100%.

If the sum of column widths is less than the specified table width, the table will shrink in width to fit exactly around the columns.

WM table screenshot
Table component running on Windows Mobile.

Table component running on BlackBerry.

<amc:table value="#{myManagedBean.allEmployees}"  
          var="emp"
          id="t1">
  <amc:column id="c1" headerText="Name">
    <amc:outputText value="#{emp.ename}" id="ot1"/>
  </amc:column>
  <amc:column id="c2" headerText="Department Number">
    <amc:outputText value="#{emp.deptno}" id="ot2"/>
  </amc:column>
</amc:table>

Attributes

Name	Type	Supports EL?	Description
align	String	Yes	Specifies the horizontal alignment of an element with respect to the surrounding context. Valid values: left (default): the component is rendered flush left. center: the component is centered horizontally. right: the component is rendered flush right. The attribute is ignored and defaulted to left when the parent Panel Group Layout has a horizontal layout. Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
backgroundColor	String	Yes	Sets the color of a background to an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
borderWidth	int	Yes	Sets the width of the borders between cells in pixels.
disabled	boolean	Yes	Specifies whether or not the component is disabled. Unlike a read-only component, a disabled component cannot receive focus.
emptyText	String	Yes	Specifies the text that is displayed when there are no rows to be shown.
focusable	boolean	Yes	Specifies whether or not this component can acquire focus set to it by the user. Unlike disabled, clicking on a focusable component will cause the component to receive focus.
foregroundColor	String	Yes	Specifies the color of the foreground of an element. The color value can be an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
height	int	Yes	Specifies the height of the component. Can be entered in pixels or as a percentage of its parent's height. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").
id	String	No	Specifies the identifier for the component. The identifier must follow the following rules: Must not be a zero-length String. First character must be an ASCII letter (A-Za-z) or an underscore ('_'). Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
rangeChangeListener	oracle.adfnmc.el.MethodExpression	Only EL	Defines a method reference to a range change listener that will be called when a new range is selected.
rendered	boolean	Yes	Specifies whether or not the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible).
selectedCellColor	String	Yes	Specifies the background of the selected cell within the selected row in a table. The color value can be an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). Default value is #FFFCD8.
selectedRowColor	String	Yes	Specifies the background of the selected row in a table. The color value can be an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). Default value is #9CACC9.
selectionListener	oracle.adfnmc.el.MethodExpression	Only EL	Defines a method reference to a selection listener.
sortListener	oracle.adfnmc.el.MethodExpression	Only EL	Defines a method reference to a sort listener.
startingSelectionMode	String	Yes	Specifies the starting selection mode of the table. Valid values: table (default): the table starts out in table selection mode. row: the table starts out in row selection mode. cell: the table starts out in cell selection mode.
value	Object	Yes	Specifies the value of the component.
var	String	No	Specifies the name of the EL variable used to reference each element of this collection. Once this component has completed rendering, this variable is removed (or reverted back to its previous value).
verticalAlign	String	Yes	Specifies the vertical alignment of a component with respect to the surrounding context. Valid values: top: the component is rendered flush top. middle: the component is centered vertically. bottom: the component is rendered flush bottom. This attribute is ignored and defaulted to top when the parent Panel Group Layout has a vertical layout. Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
width	int	Yes	Specifies the width of this component. Can be entered in pixels or as a percentage of its parent's width. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").