Input guidance for Turnkey controls
The Input Controls documentation describes ViewModel conventions for helper text and placeholders, plus tagged values for text-input types and icons.
Add persistent helper text
Helper text provides additional guidance about an input control. It occupies a single line below the input control and remains visible.
In the ViewModel Editor, create a column named <ViewModelColumn>_HelperText, where <ViewModelColumn> is the name of the input column.
For example, for an Email input column, create Email_HelperText.
Add placeholder text
Placeholder text appears in an input control when it has no value. It can provide a tip about how to fill in the control.
In the ViewModel Editor, create a column named <ViewModelColumn>_Placeholder.
For example, for an Email input column, create Email_Placeholder.
Unlike helper text, placeholder text is shown only when the input has no value.
Set a text input type
For an input intended as text, set the Texttype tagged value on the ViewModel column to override the text type.
| Intended value | Texttype value
|
|---|---|
| Password | Password
|
Email
| |
| Telephone number | Tel
|
| Web address | URL
|
| Search term | Search
|
Rendering of these input types depends on the browser.
ARIA implementation status
The supplied Input Controls documentation does not specify an ARIA tagged value, a ViewModel-column naming convention for ARIA, or the ARIA attributes generated for helper text, placeholders, text-input types, or icons.
Do not infer a particular ARIA attribute or relationship from these documented configuration mechanisms. Verify rendered output and obtain product guidance before making an ARIA-dependent implementation claim.