View Source

h2. Overview
_Since 3.0_

Renders a control to toggle the expanded state of a row in the DataTable.

If this table only contains either PanelExpansion or RowExpansion, that type of expansion will occur. If both are children of the table, the 'expansion type' for each row is configurable via the RowState.

{tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=aceMenu&exp=rowExpansionBean] of this component, complete with source code.{tip}

h2. Getting Started
{code}
<ace:dataTable var="single"
value="#{viewBean.objectList}">
<ace:column headerText="UPC">
<h:outputText value="#{single.upc}"/>
</ace:column>

<ace:column headerText="Artist">
<h:outputText value="#{single.artist}" />
</ace:column>

<ace:column headerText="Album">
<h:outputText value="#{single.album}"/>
</ace:column>

<ace:column headerText="Name">
<h:outputText value="#{single.name}"/>
</ace:column>

<ace:column headerText="Show Sales">
<ace:expansionToggler>
</ace:column>

<ace:panelExpansion>
<h:outputText value="#{single.sales}"/>
</ace:panelExpansion>
</ace:dataTable>{code}

h2. Attributes
This component has no attributes.

{tip:title=TagLib Documentation}For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/ace/tld/ace/expansionToggler.html].{tip}

h2. Event Listeners
|changeListener|Used to define a server side FacesListener which will be notified each this expansion is either opened or closed. The listener receives a single ExpansionChangeEvent argument. The server event is fired at the same time as the 'expand' and 'contract' client events of the DataTable. |

h2. Keyboard Support

Toggling of the ExpansionToggler is keyboard navigable.
|| Keypress || Result ||
| Enter/Space Key | Expand / contract expansion. |

h2. Known Issues

h2. Additional Resources

h4. Sample Applications

h4. Tutorials