cellAdded by IBM on October 10, 2012 | Version 1 (Original)
|With some limitations, the cell item can be used instead of <xforms:select1> or <xforms:select> to populate combobox, list and popup items Tags: cell item, actions, items, choices, triggering actions, dereferencing
cells, references, indirect references, XFDL, 8.0, spec
A cell can belong to multiple comboboxes, lists and popups, based on having a common <group> option setting.
Cells fall into two categories according to their behavior:
- Action cells – These cells perform the same set of actions normally associated with buttons. This includes such things as canceling, saving, and submitting the form. See the XFDL type option for a complete list of actions that are available in cells.
- Select cells – These cells provide users with a mutually exclusive set of values from which to choose. When chosen, these cells appear selected. In a list this means the cell is highlighted in some way. In a popup, the cell's label becomes the popup's label.
Available options activated, active, data, datagroup, enclosuresettings (action cell of type enclose only), group, label, itemnext, itemprevious, printsettings, saveformat, transmitdatagroups, transmitformat, transmitgroups, transmititemrefs, transmititems, transmitnamespaces, transmitoptionrefs, transmitoptions, transmitpagerefs, type, url, value
This example shows a popup that contains a list of action cells. When the user activates the popup and selects one of the actions, the action is performed. In the example, the available actions are to save the form, to close the form, or to print the form.
This example shows a popup that displays the text Select a gender. After the user makes a selection, the popup displays either Male or Female, depending on the selection made by the user.
<label>Select an action</label>
<value>Save this form</value>
<value>Close this form</value>
<value>Print this form</value>
<label>Select a gender</label>
- Use the type option to establish the behavior of a cell. The default type is select.
- Cells can have both <value> and <label> options. These options affect the form differently depending on whether the cell is linked to a combobox, a popup, or a list item. In general, the <label> of the cell is displayed as a choice, and the <value> of the cell is displayed if that cell is selected.
- Cells take their color and font information from the combobox, list and popup items with which they are associated. In this way, a cell's appearance can vary according to the list that the user is viewing.
- To get the <value> text of a cell of type select that a user has chosen from a list, dereference it in the following manner:
Similarly, to obtain the <label> of the chosen cell of type select:
Similarly, to obtain the sid of the chosen cell of type select:
- Starting with XFDL version 4.5, items of type cell are the only items that can be filtered using the XFDL <signgroups> and <transmitgroups> options.