KEYBOARDHINT attribute

The KEYBOARDHINT attribute gives an indication on the kind of data the form field contains, to let the front-end adapt the keyboard accordingly.

Syntax

KEYBOARDHINT = { DEFAULT | EMAIL | NUMBER | PHONE }

Usage

The KEYBOARDHINT attribute can be used to give a hint to the front-end, regarding the kind of data the form field will contain. According to this hint, the front-end will open the virtual keyboard adapted to the data type, especially useful when designing application forms for mobile platforms.

Valid values for KEYBOARDHINT are:
  • DEFAULT: No hint, the only hint is the data type of the program variable bound to the form field.
  • EMAIL: The field is used to enter an e-mail address.
  • NUMBER: The field is used to enter a numeric value.
  • PHONE: The field is used to enter a phone number.

For example, when defining a numeric field with the attribute KEYBOARDHINT=NUMBER, the iOS device will display a numeric keyboard when entering data into that field.


iPhone screenshot showing the keyboard optimized for numeric input.

Figure 1. Mobile application using a numeric keyboard

Example

EDIT f23 = customer.cust_phone, KEYBOARDHINT=PHONE;