diff --git a/src/.vuepress/public/.attachments/applications/Controls/phonepickerbase.png b/src/.vuepress/public/.attachments/applications/Controls/phonepickerbase.png new file mode 100644 index 000000000..624293f03 Binary files /dev/null and b/src/.vuepress/public/.attachments/applications/Controls/phonepickerbase.png differ diff --git a/src/en/developer-guide/applications/controls/phonepicker.md b/src/en/developer-guide/applications/controls/phonepicker.md index 050183a6f..6954f3048 100644 --- a/src/en/developer-guide/applications/controls/phonepicker.md +++ b/src/en/developer-guide/applications/controls/phonepicker.md @@ -1,35 +1,161 @@ --- -Author: Jan Losenicky +Author: Safija Hubljar --- - # Phone Picker -# Visual Example - -![Email Picker Displayed On Form](/.attachments/applications/Controls/phonepickercontrol.png) +

Provides features that extend the native Phone field control. Most notably:

-# Description +- **Autoformat**: Inputed number gets automatically formated based on provided country code. This includes automatic detection of country prefix. +- **Verification** (optional): If enabled, the control will check if the provided number has been verified (through SMS OTP). Verification status is displayed directly in the control. If not verified, the user has the option to trigger verification directly through the control. -This control is used to enter a phone number in field. It is checking the format of phone and also there is a function to verify the phone. -# Binding Field + -Control can be binded to field of type SingleLine.Phone, SingleLine.Text and SingleLine. +## Bindings -# Inputs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Property NameDescriptionOf TypeInputOutputUsageRequired
phoneNumberPhone number field +

SingleLine.Phone

+

SingleLine.Text

+ SingleLine

+
+ 111 222 333 +

{"phoneNumber": "111222333",
"asyncJobInstanceId": null, +
"prefix": +420",
"status": "unverified",
"type": 0,
"url": null,
"verifiedOn": null} +

+

{"phoneNumber":"111 222 333",
"prefix":"+420",
"status":"unverified",
"type":2}

boundtrue
entityName

Entity name of the record the PhonePicker is on. Required if verification feature is on.

SingleLine.Text + account + N/Ainputfalse
defaultCountryCodeDefault Country code. CZ by defaultSingleLine.Text + CZ + N/Ainputfalse
placeholderMessagePlaceholder messageSingleLine.Text + --- + N/Ainputfalse
verificationFeatureEnable the functionality for verification phone number.Enum +

0

+

1

+
N/Ainputtrue
verificationDialogDisabledField for disabling the verification dialog.Enum +

true

+

false

+
N/Ainputfalse
enforceMobileEnforces the use of a mobile number or allows a landline.Enum +

0

+

1

+
N/Ainputfalse
callFeatureEnable call functionality.Enum + 0

+ 1

+
N/Ainputfalse
plainPhoneBinding field returning plain phone number +

SingleLine.Phone

+

SingleLine.Text

+

SingleLine

+

+420 111 222 333

+420 111 222 333

boundfalse
clickToCopyEnabledEnable click to copy button.Enum +

true

+ false

+
N/Ainputfalse
-- Default Country Code - Set to "CZ" by default. -- Place Holder Message - Default vaule is "---" -- Call Feature - - Disabled - - Enabled (default) -- Enforce Mobile - Enforce mobile phone or allow landline - - Disabled - - Enabled (default) -- Verification Feature - - Disabled (default) - - Enabled +## Changelog -Using Verication Feature -- Entity Name (required) -- Record Id (required) \ No newline at end of file +

2024-08-07

+

Changed

+ \ No newline at end of file