Table of Contents


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.

See the ICEfaces Showcase Live Demo of this component, complete with source code.

Getting Started

<ace:dataTable var="single"
    <ace:column headerText="UPC">
        <h:outputText value="#{single.upc}"/>

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

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

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

    <ace:column headerText="Show Sales">

        <h:outputText value="#{single.sales}"/>


This component has no attributes.

TagLib Documentation
For reference, the complete taglib documentation for this component is available here.

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.

Keyboard Support

Toggling of the ExpansionToggler is keyboard navigable.

Keypress Result
Enter/Space Key Expand / contract expansion.

Known Issues

Additional Resources

Sample Applications


Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

© Copyright 2021 ICEsoft Technologies Canada Corp.