About TotalRow

Use the totalRow component to let users update the totals of one or more numerical columns in a table. This component is not supported on the following agent types: pda, phone, voice.

The totalRow component must be used in the total named child of tableFooter on a table component. When used this way, ADF UIX creates a total row in the table footer. This total row has a button followed by the text 'Total'. By default a localized version of the text 'Recalculate' is provided in the button. To change the button text, set the text attribute on totalRow to the desired text.

Table with Recalculate button and Total in footer

The other attributes you can set for totalRow are:

destination - Specifies the URI the button references.
readOnly - Specifies a boolean value that determines whether the button should be rendered. Default is false.

The link in the button is a generated URL based on the destination attribute. If the formSubmitted attribute on the parent table is set to true, then a form submission link is generated instead. The following form field/value pairs from the table are submitted:

event - value set to "update"
source - value set to the table id

The same two keys and values are also sent as parameters in the event of a URL link.

Note: The totalRow component does not perform calculations. You must calculate the total and display it in a textInput field yourself. Set the footer child of a column component with an input field for the updated total.


...
<table id="tb2" 
       tableData="${uix.data.demoTableData.demoRowData}" 
       rowHeaderData="${uix.data.demoTableData.demoRowHeaderData}">
  <contents>
    <column>
      <columnHeader>Row</columnHeader>
      <contents>
        <text text="${uix.current.firstColumnText}"/>
      </contents>
    </column>
    <column>
      <columnHeader>Text</columnHeader>
      <contents>
        <styledText text="${uix.current.secondColumnText}"/>
      </contents>
    </column>
    <column>
      <columnHeader>Amount</columnHeader>
      <columnFormat columnDataFormat="numberFormat"/>
      <contents>
        <text text="${uix.current.thirdColumnText}"/>
      </contents>
      <!-- This column footer child is used with totalRow -->
      <footer>
        <textInput columns="2" name="sometotal" text="42"/>
      </footer>
    </column>
  </contents>
  <!-- footer child of table contains tableFooter -->
  <footer>
    <tableFooter>
      <!-- total named child of tableFooter contains totalRow -->
      <total>
        <totalRow>
          <contents/>
        </totalRow>
      </total>
    </tableFooter>
  </footer>
  ...
</table>
...