The Secure Text Input Web Control collects information from a user kept in a secure source. The client-side code cannot access this data. To retrieve the data, you must use the Secure Value Retrieval Data Operation and pass the SecureKey. The Secure Text Input is ideal for collecting sensitive user information like Social Security Numbers or Credit Card Information. Using this control prevents the front-end environment from having access to the value the user has entered.
Properties
General
Placeholder Text
Expects type text.
Text to be displayed in the text input until the user enters the box.
Data Binding
Value
Expects type text.
By default, a Variable of type Text is generated 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.
Selected
Expects type text.
By default, a Variable of type Text is generated 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.
Autocomplete
AutoComplete
Determines the autocomplete mode for the input. Check out MDN for more details on what options are available.
Input Format
Expiration Duration
Expects type number.
Determines for how long the secure string will be available. Options are:
- Day(s)
- Hour(s)
- Day(s)
Maximum configurable duration is 7 days.
Maximum Length
Expects type number.
Determines the maximum number of characters that the input will allow.
Input Mode
Determines the mode of the keyboard for a mobile device.
- text - (default) allows all text from a standard keyboard.
- decimal - allows for numbers with decimals to be entered.
- numeric- allows for numbers to be entered.
- tel- for inputting telephone numbers.
- search- for search inputs, the enter button the keyboard will change to "search"
- email - for email addresses
- URL - for entering a web URL.
Format
Determines how the text will be rendered. For example, selecting the date format and dd/mm/yyyy will cause the input to format a data as "04/04/2044."
Delimiter
Separates input values. When a user enters this character or sequence of characters, into the secure input, it will be ignored.
Prefix
Expects type string.
Sets a value that is displayed as a placeholder and is affixed to the beginning of the value. This value is stored as part of the input the user enters by default.
No Immediate Prefix
Defers displaying the Prefix until there is a value in the field or the field is being edited.
Raw Value Trim Prefix
If checked, the prefix will be trimmed from the value stored in the secure string output.
Icon
Right Icon
Displays the icon at the right of the input. Default is password-visibility. If another icon is chosen, the user won't be able to toggle between hidden and shown visibility.
Accessibility
Aria Label
Expects type text.
The aria-label attribute is used to define a string that labels the current element. It is used to provide an accessible name for the control. For more information see here.
Input ID
Expects type text.
The Input ID assigned to the Secure String Input Web Control. This Input ID can tied to a Label so that clicking on the associated Label will allow users to enter a Secure String.
For more on how to use the Input ID, see Connecting Labels to Input Controls.
State
Is Visible
Expects type boolean.
If TRUE the control will be visible. If FALSE the control will not be displayed. If the field is empty, the control will be visible.
Is Disabled
Expects type boolean.
If TRUE the control will be disabled and the user will not be able to interact with the control. If FALSE the button will be enabled. If the field is empty, the control will be enabled.
Style
This control has styles for the following states:
Default - When first rendered without state
Focused - when the Checkbox is focused
Disabled - When the Checkbox is disabled
Check Common style properties of web controls for further details on how to style this Web 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 when a character is added or removed from the Secure Text Input. Because the Secure String does not have a control value binding property, the event.value will contain the information needed to retrieve the text entered.
In order to retrieve the secureValueKey, set a variable on the Value Change action to
event.value
On Enter
Triggers when the user hits the enter or submit button at the end of the input.
Example
Insert a Secure Text Input. Map the event.value to an activity variable. The Secure String Input can now collect a password to log into an app.