The commandSortHeader component is used in conjunction with a dataTable. The commandSortHeader renders a clickable column header facet allowing the user to toggle the sort order of data in the table, either ascending or descending based on the values in the column.
The commandSortHeader can be used to provide a user-controlled data sorting capability to a dataTable.
Attributes |
Name | Required | Request-time | Type | Description |
action | false | false | java.lang.String | MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application. |
actionListener | false | false | java.lang.String | MethodExpression representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing where the event came from, but this can be useful in cases where a notification is needed that "some action happened". |
arrow | false | false | java.lang.String | Indicates whether an arrow, that shows the sort direction should be rendered. Default: false Note: This is deprecated. It no longer has any effect in 1.7. To alter the appearance of the arrow images, the following style classes need to be customized: - iceCmdSrtHdrAsc
- iceCmdSrtHdrDesc
|
binding | false | false | java.lang.String | The value binding expression linking this component to a property in a backing bean |
columnName | false | false | java.lang.String | The name of this column. This name must uniquely identify this column among all other (sortable) columns in the same data_table. The sortColumn attribute of the embedding data_table reflects the current sort column (see extended data_table). |
disabled | false | false | java.lang.String | Flag indicating that this element must never receive focus or be included in a subsequent submit. |
enabledOnUserRole | false | false | java.lang.String | If user is in given role, this component will be rendered normally. If not, the component will be in disabled state. |
id | false | false | java.lang.String | The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
immediate | false | false | java.lang.String | Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase. |
rendered | false | false | java.lang.String | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. |
renderedOnUserRole | false | false | java.lang.String | If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. |
styleClass | false | false | java.lang.String | The base name for all style classes. Default value is iceCmdSrtHdr if enabled and iceCmdSrtHdr-dis if disabled. |
value | false | false | java.lang.String | The current value of this component. |