Overview
This is a very simple text entry field used for input/output.
The 'value' property is where you set a initialized value for the textbox. Whatever you place inside the 'value' will be present when the textbox is displayed.
Validation (Rich UI Only)
(Input link to validation and error messages page under Input Widgets section)
Field Binding Dialog (Rich UI Only)
(Input link to Field Binding page under Widget section)
Field Settings - Input Type (Rich UI Only)
These properties are used to specify an input type for the textbox. These are primarily used for mobile applications, but some of these input types are supported by HTML5 capable browsers. If this field is not set a standard textbox element will be used by default.
Date - The Date input type is used to create a date field for the textbox. When supported it allows your user to select a date which is automatically formatted for the field and returns the date as a value.
Datetime - Similar to the Date input type this allows the user to select a date and time (with time zone).
Email - This input type would be used for a field you are expecting an email address to be entered. For mobile browsers this field allows your device to recognize the email type and change the on-screen keyboard to match (giving @ and .com options depending on the device).
Time - The time input type gives the user a field to accept a time entry format. This input type does not give a time zone like the datetime type.
Month - The month input type functions like the Date type, with the exception there is no day indicated in the format. It allows the user to only select a month and year.
Number - The number type should be used when a field is set to contain a numeric value you want to impose a restriction on.
Tel - This input type would be used for a field needing a telephone number format.
URL - The url type is for input fields containing a URL address. For mobile browsers this field allows your device to recognize the email type and change the on-screen keyboard to match (giving .com options depending on the device).
Auto-Complete Choices
Auto-complete allows your textbox field to automatically suggest choices based on text entered into the textbox.
The auto-complete choices/values can be populated multiple ways:
Comma separated list - A simple list of values separated by just a comma (i.e. Apple, Orange, Banana).
Database file - See Database-Driven Auto-Complete section below.
JSON array format - Using JSON array format, meaning the choices/values are enclosed in a bracket with quotations and then comma separated (i.e. ["ElementOne", "ElementTwo"] ) within the choices and choice values fields also allows you to populate the auto-complete, these fields can also be bound to an RPG field (Rich UI only).
Web service - You can pass JSON through a web service such as a PHP program to complete the choices and choice value fields (see choices URL example below).
Database-Driven Auto-Complete
This section allows the correct choices to be retrieved from a database file. In order to use this, simply enter the name of the database file, the name of the choice option field(s) you would like to search by, and the name of the choice value field you wish to return to your application..
If there are multiple fields specified in the choice options field this will allow you to return multiple values
The selection criteria can be used to filter the choices similar to an SQL WHERE clause. There is no need to qualify the database file name with a library name, although you can if required. Once the file name has been entered, the "..." button in the choice options and choice value fields will open the dialog box shown below. This dialog lists all the fields in the specified file allowing easy selection of the correct field names