# Phone Input

![](https://3333962744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbnBffrSN2FHLC5cM89AM%2Fuploads%2Fgit-blob-a6930d6f599e08f184a71cf6c8a8cec0b5d5ba8d%2Fphone-input-web-control-v183-0.png?alt=media)

The Phone Input Web Control captures phone numbers. It is similar to the [Text Input Web Control](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-expressions/phone-functions/isphone) Airscript function), the phone input value will evaluate to `NULL`.

## Properties

### General

#### Placeholder Text

Expects type `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.

#### Input ID

Expects type `text`.

The Input ID assigned to the Phone Input Web Control. This Input ID can tied to a [Label](label-web-control) so that clicking on the associated Label will allow users to enter Phone input.

For more on how to use the Input ID, see [Connecting Labels to Input Controls](https://github.com/airkit/airkit-docs/blob/master/docs/v18-3/connecting-labels-to-input-controls.md).

### Data Binding

#### Value

Expects type `phone`.

By default, this Data Binding property auto-generates a Variable of type [Phone](../variable-data-types/the-phone-variable-data-type) 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.

#### Data Tag

Assigns a data tag on the value of the control. For more information, see [Data Masking and Auditing](https://support.airkit.com/v18.3/docs/data-masking-and-auditing).

### Autocomplete

#### 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-code**or **tel-locale**. For more information, see the [HTML autocomplete attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete).

### Input Format

#### Delimiter

Displays the symbol that delimits sections of a phone number as it is entered.

For instance, if the "-" symbol is selected from the dropdown, 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](../airscript-expressions/phone-functions/isphone).

#### No Immediate Prefix

Defers displaying the **Prefix** until there is a value in the field or the field is being edited.

By default, this checkbox is not selected.

### Icon

#### Right Icon

Displays the icon that will appear on the right of the input box.

The default option, "-", dictates that no icon will be visible.&#x20;

### Accessibility

#### Aria Label

Expects type `text`.

Defines a value to the aria-label of the control for accessibility. For more information see [here](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html).

### State

#### Is Visible

Expects type `boolean`.

If `TRUE` the phone input will be visible. If `FALSE` the phone input will not be displayed. If the field is empty, the phone input will be visible.

#### Is Disabled

Expects type `boolean`.

If `TRUE` the phone input will be disabled and the user will not be able to interact with the control. If `FALSE` the phone input will be enabled. If the field is empty, the phone input will be enabled.

## Style

This control Variant has styles for the following states:

**Default** - When first rendered without state\
**Focused** - when the Phone Input is focused\
**Disabled** - When the Phone Input is disabled

Check [Common style properties of web controls](https://github.com/airkit/airkit-docs/blob/master/docs/v18-3/web-control-styling-properties.md) for further details on how to style this control.

## Actions

#### 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](checkbox-web-control)[,](checkbox-web-control) where its Value changes when the box is selected.

#### On Enter

Triggers upon pressing Enter.

Check out [Action Inspector Tab](https://github.com/airkit/airkit-docs/blob/master/docs/v18-3/action-chains.md) to find all the available actions.

## Example

To collect phone numbers from users around the globe, select the '+' icon in **Prefix** to indicate that country code is expected.

![](https://3333962744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbnBffrSN2FHLC5cM89AM%2Fuploads%2Fgit-blob-a6930d6f599e08f184a71cf6c8a8cec0b5d5ba8d%2Fphone-input-web-control-v183-1.png?alt=media)
