See Common asset properties for details of common properties shared by different assets

Appearance

Normal state is the state of the Text Input Asset when it is not in focus.

• Fill color: defines the background color
• Outline thickness: defines the outline thickness from a scale of 0 to 10
• Outline color: defines the outline color
• Outline radius: specifies the roundness of the four corners on a scale of 0 (squared) to 50 (rounded).

Edit state is the state of the Text Input asset when it has focus.

• Edit fill color: defines the background color of the Text Input Asset in edit state
• Edit outline color: defines the outline color of the Text Input Asset in edit state
• Edit outline thickness: defines the outline thickness of the Text Input Asset in edit state
• Edit outline radius: specifies the roundness of the four corners on a scale of 0 (squared) to 50 (rounded).

Selection refers to the moment editing - typing or highlighting - is actively occurring within the Text Input Asset.

• Caret color: defines the color of the blinking cursor
• Selection area color: defines the background color of selected text

Effects See Common asset properties for details about Visibility & Effects properties

Text

• Text: Text value in the text input asset. Use it to prefill the input field or to access the text entered by a user. You can also modify this text directly in the Scene by double-clicking the Text Input asset.
• Font, Font color, Font size, Bold, Italic: Text style configuration
• Adapt font size: Toggle whether the font size of text should shrink in order to maintain visibility within its container.
  • Minimum font size: The size below which "Adapt font size" will not shrink the text. Overflow text will not be visible.
• Line wrap: Toggles whether entered text will wrap at the end of the line. In addition, if Line wrap is selected and the trigger Enter key pressed is not being used, a press of the Enter key will cause a linefeed to appear within the Text Input field.
  NOTE: alternatively, you can also use Shift+Enter keys or Alt+Enter keys while in the Text Input to add a line break.
• Horizontal alignment: Specify how entered text should be aligned horizontally within the Text Input box
• Vertical alignment: Specify how entered text should be aligned vertically within the Text Input box
• Margin: Minimum separating the left and right borders of the Text Input box and an entered character

Behavior

Characters

• Expected Format: [available when Use regular expression is deselected] specify permitted character types. Invalid characters cannot be entered by the user.
• Min characters: Minimum number of required characters for a valid entry
• Max characters: Maximum number of required characters for a valid entry
• Use custom regular expression: toggle whether you want to use a custom regular expression or prebuilt "Expected format" validation criteria (see next property) to prevent users from entering invalid content
• Regular expression: [available when Use regular expression is selected] enter a regular expression to determine whether entered text is valid. Invalid characters are determined after the Text Input asset loses focus.
• Specify keyboard layout: choose whether or not you want Intuiface to select a keyboard format for you based upon the selected Expected format. If you want to force a keyboard layout, you have these choices:
  • Standard

  • Numpad

  • Standard + Numpad

Password

• Mask: toggle whether or not you want to mask - i.e. hide - entered characters with an alternate character. Use of the mask would be appropriate for password entry. If selected, two additional properties are revealed:
  • Mask character: the character to be used if masking entered characters
  • Visibility time: length of time, in milliseconds, to display the entered character before replacing with the Mask character

See Triggers Overview to get details of common triggers shared by all assets or collections

• Enter key is pressed: Raised when this Text Input asset has focus and the Enter key is pressed on the keyboard (virtual of physical).
• Is given focus: Raised when this Text Input asset is selected for text entry.
• Keyboard key(s) pressed: Raised when the specified key or keyboard shortcut is pressed.
• Loses focus: Raised either when 1) the user validates their input by typing the ENTER key, or 2) the user selects a different Text Input asset.
• Text is updated: Raised every time a character is typed into this Text Input asset. This trigger raises the following parameters:
  • New value
  • Old value

Validation

• Identifies an invalid character: Raised as soon as a user types a character outside the scope of the regular expression or expected character format. This trigger raises the following parameter:
  • Invalid character
• Identifies invalid text: Raised when this Text Input asset loses focus. Occurs when overall text violates expected character format or length presets.
• Validates the entered text: Raised when this Text Input asset loses focus and the text is found to be valid.

See Actions Overview to get details of common actions shared by all assets or collections

• Empty text field
• Enter editing mode
• Exit editing mode
• Set text
  • New text