Use the Text Entry Web component when you would like the user to provide text entry such as for their name or address. A text entry Web component allows a user to enter an arbitrary text value; whereas, Web components such as Combo box or Check box ensure that only certain values can be submitted. A text entry Web component can also be used to display output. For example, if you would like a user to be able to edit a text value that has been sent to their browser as output.
Default specifies that the text direction and the alignment of the Web component on the page are inherited from the containing element. For example, if the Web component is inserted in a form, and the form's orientation is specified as Right-to-left, then the orientation for the Web component is also Right-to-left. The default is Left-to-right.
Right-to-left specifies that the text direction is right-to-left, and that the Web component is right-aligned on the page. This value overrides the inherited value.
Left-to-right specifies that the text direction is left-to-right, and that the Web component is left-aligned on the page. This value overrides the inherited value.
The available values for client-side validation are None, Comparison, or Range.
If either Comparison or Range is selected, the Define button is enabled.
When Comparison is selected, the Define button opens the Comparison Validation window, where:
See Text string substitution for iSeries Web component labels for information about externalizing text strings for text substitution purposes.
When Range is selected, the Define button opens the Range Validation window where:
See Text string substitution for iSeries Web component labels for information about externalizing text strings for text substitution purposes.
See Text string substitution for iSeries Web component labels for information about externalizing text strings for text substitution purposes.
You can externalize the comparison value, minimum value, and maximum value in a properties file to support different languages. For example, a numeric value in English is "123.45," and will be "123,45" in French, due to the different locale value for the decimal point. Therefore, values for validation may vary for different languages. You can specify these values in the properties file.
Validation is performed automatically when a user enters data in the text entry field and then moves the focus elsewhere on the page.
For any validation errors, an error message is displayed. The messages are stored in the messages.js file in the Web project. Message text can be changed by editing the messages.js file. For national language purposes, the message text can be translated.
Formatting of data is performed automatically if an initial value has been defined in the attribute view of the Web component, or if data is assigned to the Web component at run time by the host program, or the data entered by the user at run time. The formatting is performed by the tag library at run time and before it is displayed in the field.
For data entered by the user in the browser, formatting is performed when focus is no longer on the field. If the user clicks on the field again, then the field displays the data as it appeared when it was originally entered.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.