ICEfaces Component Suite
Tag rowSelector


The Row Selector tag enables single and multiple row selection for DataTable. To add the row selection to the dataTable, the rowSelector component can be added to any column of the dataTable(e.g.)

<ice:dataTable..>
  <ice:column>
    <ice:rowSelector .../>
    <f:facet name="header">
      <ice:outputText ..../>
    </f:facet>
    <ice:outputText ...../>
  </ice:column>

Note:


Tag Information
Tag Classcom.icesoft.faces.component.RowSelectorTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.lang.String The value binding expression linking this component to a property in a backing bean
clickActionfalsefalsejava.lang.String

Action method to call when a row is clicked or double-clicked.

clickListenerfalsefalsejava.lang.String

Listener method to call with a ClickActionEvent when a row is clicked or double-clicked. This listener is fired independently of selectionListener. The ClickActionEvent object contains a reference to a RowSelectorEvent if the click or double click resulted in (de)selection of the row, otherwise it will be null. ClickActionEvent.isDblClick() determines whether the click event was a single click or a double click.

clickedRowfalsefalsejava.lang.String

The table row that was last clicked. Setting this to some value will not effect row selection.

dblClickDelayfalsefalsejava.lang.String

The delay or timeout in milliseconds to wait for a second click (after a first click has been made on a row) to notify the server whether the ClickActionEvent was a single click or a double click. This attribute only applies when clickListener and/or clickAction are specified. Valid values are 0 to 1000. Default is 200.

enhancedMultiplefalsefalsejava.lang.String

When enhancedMultiple is true, it allows following selection behaviour:

  • "Click" selects clicked row and deselects rest
  • "Click + Ctrl" flip the selection of clicked row and keeps previous selection intact
  • "Click + Shift" selects all rows from last clicked row to newly clicked row, and deselect rest
  • "Click + Shift + Ctrl" selects all rows from last clicked row to newly clicked row and keeps previous selection intact

idfalsefalsejava.lang.String The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatefalsefalsejava.lang.String

If true, the selectionListener and selectionAction will be executed immediately, during Apply Request Values phase of the request processing lifecycle, and if false, during the Invoke Application phase. The default value is true, for backwards compatibility.

mouseOverClassfalsefalsejava.lang.String

This method has been deprecated in 1.6. Please use the styleClass instead.

multiplefalsefalsejava.lang.String

When true, more then one row can be selected. Default is false.

preStyleOnSelectionfalsefalsejava.lang.String

When the user (de)selects a row, there can be a latency with the network communication with the server, and the JSF lifecycle executing, before the client will be updated to depict the row selection. When preStyleOnSelection is true, the table row's styling will be updated immediately, improving the application's perceived responsiveness. When applications directly manage row selection, on the server side, to implement specific rules for (de)selection, they should see this to false, to avoid styling being set and reset. For backwards compatibility with such applications, the default value is false.

renderedfalsefalsejava.lang.String Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRolefalsefalsejava.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.
selectedClassfalsefalsejava.lang.String

This method has been deprecated in 1.6. Please use the styleClass instead.

selectedMouseOverClassfalsefalsejava.lang.String

This method has been deprecated in 1.6. Please use the styleClass instead.

selectionActionfalsefalsejava.lang.String

Action method to call when a row is clicked

selectionListenerfalsefalsejava.lang.String

Listener method to call with a RowSelectorEvent when a row is (de)selected

styleClassfalsefalsejava.lang.String

Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
Default value is iceRowSel:
Style Classes Used:

  • iceRowSelMouseOver
  • iceRowSelSelected
  • iceRowSelSelectedMouseOver

toggleOnClickfalsefalsejava.lang.String

Do row selection on mouse click. When false, row (de)selection will not happen when the user clicks on a table row. Default value is true.

toggleOnInputfalsefalsejava.lang.String

Do row selection, even when the user clicks on an input field or link in a table cell. Default value is true. When false, row (de)selection will not happen when the user clicks inside an input field, list, menu, button, or link.

valuefalsefalsejava.lang.String

A ValueBinding to a per dataTable row java.lang.Boolean property, which determines if that row is selected. Typically the ValueBinding refers to a property of the dataTable's var attribute, but another strategy is to use a smart java.util.Map to centrally maintain the selection state.


Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.