Renders a hidden panel with controls to configure column features. The table whose columns are to be configured is targeted with the 'for' attribute. The location of the button to reveal this panel is configured via the 'type' attribute.
The table config panel renders three buttons, a checkmark which submits changes, a crossout that closes without submitting changes, and a trashcan, that closes and resets the column properties configurable via the table config panel to an unconfigured state.
| Client Events |
| Name | Description | Supported Classes for Argument | Default Event Scopes |
|
| open | Fired when the TableConfigPanel is shown. | javax.faces.event.AjaxBehaviorEvent | execute=@this render=@all |
| submit | Fired when the TableConfigPanel submits its changes and closes. | javax.faces.event.AjaxBehaviorEvent | execute=@this render=@all |
| cancel | Fired when the TableConfigPanel cancel its changes and closes. | javax.faces.event.AjaxBehaviorEvent | execute=@this render=@all |
| trash | Fired when the TableConfigPanel clears out it's changes and closes. | javax.faces.event.AjaxBehaviorEvent | execute=@this render=@all |
| Attributes |
| Name | Required | Request-time | Type | Description |
| accesskey | no | true | java.lang.String | Access key that, when pressed, transfers focus to this component. |
| binding | no | true | javax.el.ValueExpression | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean. |
| columnNameConfigurable | no | true | boolean | Enable the configuration of column headerText properties. |
| columnOrderingConfigurable | no | true | boolean | Enable the configuration of column order. |
| columnSortingConfigurable | no | true | boolean | Enable the configuration of column sorting priority and directions. |
| columnVisibilityConfigurable | no | true | boolean | Enable the configuration of column visibility. |
| dragHandle | no | true | java.lang.String | Defines a CSS selector of a TableConfigPanel subregion used as the handle when dragging the panel. |
| for | no | true | java.lang.String | Defines the component ID of the DataTable this ConfigPanel manipulates. |
| hideDisabledRows | no | true | boolean | When set to true, the disabled rows in the panel (corresponding to ace:column's that have their 'configurable' attribute set to false) will not be rendered, instead of rendering them with a disabled styling. Default = 'false'. |
| id | no | true | java.lang.String | The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
| inColumnId | no | true | java.lang.String | Defines the column to render the 'launch' panel button in when using the 'in-col-left' or 'in-col-right' type options. |
| modal | no | true | java.lang.Boolean | Specify whether viewing this panel disables the rest of the application from input. Default = 'false'. |
| offsetLeft | no | true | java.lang.Integer | Define the distance in pixels from left boundary of the CSS positioning bounding parent. If undefined, the panel is positioned offset slightly from the target DataTable. |
| offsetTop | no | true | java.lang.Integer | Define the distance in pixels from top boundary of the CSS positioning bounding parent. If undefined, the panel is positioned offset slightly from the target DataTable. |
| rendered | no | true | boolean | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'. |
| type | no | true | java.lang.String | Defines the display mode for the 'open' control panel button. Available options: first-col, last-col, in-col-right, in-col-left Default = 'first-col'. |