Overview
The Phone Input Web Control can be used to capture phone numbers. It is similar to the Text Input Web Control, but it has some validation built in: if a value entered into the Phone Input Web Control is not a valid phone number (as defined by the ISPHONE Airscript function), the phone input value will evaluate to NULL.
Control Properties
Placeholder Text
The text that is displayed in the input’s box before the user starts typing. This will only display if the No Immediate Prefix checkbox (see blow) is checked.
Advanced Control Properties
Delimiter
Select the symbol will delimit sections of a phone number as it is entered.
For instance, if the "-" symbol is selected, a phone number entered as "+17167762323" will display as "+1-716-776-2323"
Prefix
The prefix that will appear automatically in the displayed input box.
Most commonly, this is used to automate the insertion of the relevant country code, which is necessary in order for Airscript to correctly parse phone numbers.
No Immediate Prefix
If this checkbox is selected, no prefix will appear in the displayed input box, regardless of what is entered in the Prefix section above.
By default, this checkbox is not selected.
Right Icon
Select the icon that will appear on the right of the input box.
The default option, "-", dictates that no icon will be visible.
AutoComplete
Determines whether the user's device is allowed to autocomplete the field. Guidance can be provided to the app user's browsing environment by using one of the pre-determined autocomplete options such as tel-country-codeor tel-locale. For more information, see the HTML autocomplete attribute.
Data Binding
Value
By default, this Data Binding property auto-generates a Variable of type Phone at the Web Page level to store the data from the input.
Users can also edit the Data Binding property and create their own Variables.
Style
Variant
Phone Inputs can be styled with these controls. For more information, see Common Style Properties of Web Controls.
Further customization is possible with different Variants, font types, sizing and spacing being editable on the Inspector. Click on the desired Variant and the element on the Stage will change to match. For further information, see Themes and Variants.
Control Actions
In the Actions Tab of the Inspector section, the Phone Input actions can be defined.
On Blur
Triggers when the user leaves the input field. That is, when changing the focus from the field to some other part of the application.
Value Changed
Triggers with each typed character. That is, with an phone input, the Value changes every time a key is pressed, unlike a Checkbox, where its Value changes when the box is selected.
On Enter
Triggers upon pressing Enter.
Please check out Action Builder to find all the available actions.
Advanced
In the Advanced Tab of the Inspector section, the conditions under which this Web Control is visible can be defined by setting a specific parameter.
Is Visible
This property is a conditional field, which allows to show or hide the field depending on whether the set condition is met. The condition will always evaluate to a Boolean.
Is Disabled
This property is a conditional field, which allows to enable or disable the field depending on whether the set condition is met. The condition will always evaluate to a Boolean.