Project Documentation

Summary

Tag name: <tr:returnActionListener>

The returnActionListener tag is a declarative way to allow an action source (<commandButton>, <commandLink>, etc.) to return a value from a dialog or process. It calls the returnFromDialog method on the RequestContext. This tag can be used both with ADF Faces commands and JSF standard tags. More generally, it can be used with any component at all that implements the standard ActionSource interface.

Example:

This example shows dialog page with a table. The table has a "Select" button, which when clicked will close the dialog and return the selected Employee Number (Empno). There is also a "Cancel" button, which when clicked will close the dialog without returning a value.

            <tr:table var="row" value="#{....}">
              ...
              <tr:column headerText="Employee Number">
                <outputText value="#{row.Empno}"/>
              </tr:column>
              <tr:column headerText="Employee Name">
                <outputText value="#{row.Ename}"/>
              </tr:column>
              <f:facet name="selection">
               <tr:tableSelectOne>
                <tr:commandButton text="Select">
                  <tr:returnActionListener value="#{row.Empno}"/>
                </tr:commandButton>
               </tr:tableSelectOne>
              </f:facet>
            </tr:table>
            <tr:commandButton text="Cancel">
              <tr:returnActionListener/>
            </tr:commandButton>

Attributes

Name Type Supports EL? Description
valueObjectYes The value to return as the dialog/process result. This can be an EL expression or a constant value.