XForms optionsAdded by IBM on October 10, 2012 | Version 1 (Original)
|XForms options are required when you are creating an XFDL form that contains an XForms data model. XForms options link the XFDL items on the form to the XForms data model, so that the items and model share data.
XForms options belong to the XForms namespace. However, in most respects these options are treated just like XFDL options. They are added to the syntax of the form at the same level, set particular characteristics for the containing item, and are recognized by the XFDL parser.
Despite this, XForms options do have some features that differ from XFDL options. This chapter describes these features and then details each of the XForms options separately.
Items are linked to the XForms data model through the XForms options they contain.
A nodeset binding links an element in the form to a set of data elements.
The relevance of display elements is determined based on their binding.
Many of the XForms options support the inclusion of metadata sub-options. These sub-options are optional, and provide information that is passed to the user interface, including alerts and help messages.
Contains the XForms model data.
Attaches properties and constraints to a nodeset in the model.
Links a field, combobox or check box to an element in the data model so that they share data. However, the xforms:input only support a single line of data.
Contains the XML data of the XForms model. The data must be valid XML with a single root, allowing the use of existing data models from other applications.
Contains the instance data, binds, and submission information for the form. Can also contain schema information that applies to the instance data.
Links a button or a label to information in the XForms data model. This allows you to display images or text from the data model on the face of a button or label.
Sets the range of values a user can select with a slider item.
Creates a template row of items for a table. These items are then duplicated for each row the user adds to the table, and for each row of data that exists in the XForms data model.
Links a field to an element in the XForms data model, and makes the field write only.
Sets the choices that are displayed by a checkgroup or list when the user can select one or more of the choices. When the form is processed, an individual check or cell item is automatically generated to represent each choice.
Sets the choices that are displayed by a checkgroup, radiogroup, list, popup, or combobox. The xforms:select1 option limits users to selecting one of the choices.
Specifies which data to submit, and how to submit it.
Sets a button or action item to perform an XForms submission. The rules for the submission are defined in the XForms data model. The xforms:submit links a button to a particular set of rules, which are then carried out when the button is clicked.
Divides a portion of the form into sets of items, and then controls which set is shown to the user. For example, you may have a form page with Basic and Advanced settings, and may only want to show one type of settings to the user at any given time.
Triggers an event in response to an XFDL action or the user clicking an XFDL button. The event is expressed as an XForms action, which allow you to make various changes to the form. For example, you could use an XForms action to set which case in a switch statement is true, or you could us an XForms action to insert or delete items on the form.
Links a multi-line field to an element in the data model so that they share data. For example, if you added an xforms:textarea option to a field in your form, you could use that option to link the field to an element in your data model. Once linked, any changes made to the data in one would be reflected by the other.
Sets a button to attach a file to the form. The file is loaded directly into the XForms data model as base64 data. If the file is an image, you can use an xforms:output to display the file to the user.