Development tools : XUI editor : XUI widgets and containers : Containers Description : Form
  
Form
The Form container is used to fill with other widgets and submit data. For example, developers usually place widgets like text, label and combo box in a form container. These widgets are often bound to predefined data within the transaction.
Implementation base
The Form widget is a Dojo-based widget:
com.ibm.btt.dijit.Form
Properties for the Form widget
 
Property
Description
id
The identifier for the widget.
validateOnSubmit
The validateOnSubmit property specifies whether validation is required for the widgets that are contained in the form. If the validateOnSubmit property is set to true and any of the widgets that are contained in the form fail during validation or the cross validation fails, the submit button is disabled. The default value is true.
fastTab
The fastTab property specifies Boolean value. The form can be focused by Tab when the fastTab property is specified astrue (default).
defaultAction
The defaultAction property specifies the default server-side action that ran when the form is submitted. This property is set in the Action tab of the Properties view. The defaultAction property consists of the following subproperties:
flowEvent
The flowEvent is the event that is sent to the UDTT navigation flow and causes the processor to proceed to the next state when the form is submitted.
flowId
The flowId is the ID of the UDTT flow that is started when the form is submitted. If a flowId is specified, a new flow instance is created and initiated on the server.
operationId
The operationId is the ID of the UDTT operation that is started when the form is submitted.
The values that are specified for the defaultAction property are used in the following scenarios:
When a user clicks a submit button and the action property of the submit button does not have a value.
When a user submits a form by using a mechanism other than by clicking a submit button, for example, by pressing the Enter key.
When the submit() method is started by client-side code.
styleClass
The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets.
width
The width property specifies the width of the widget. This property is set in the Appearance tab of the Properties view.
height
The height property specifies the height of the widget. This property is set in the Appearance tab of the Properties view.
generateLayout
The generateLayout property specifies whether to generate the HTML layout. The default value is true.
generateInlineStyle
The generateInlineStyle property specifies whether to generate the inline styles. The default value is true.
Cross-field validation
Cross-field Validation function is used to validate multiple fields in a form if their values are correlative. Submit type buttons in the form is disabled until all the defined cross-field validations for the form are valid. For more information, see Defining xValidation in XUI editor.
See
ECA editor support
Go up to
Containers Description