A box in which the user can type text, numbers, and other data.

Description

The user can specify data by typing into a text-input control. Depending on how you configure the app, that data might be added to a data source, used to calculate a temporary value, or incorporated in some other way.

Key properties

Default – The initial value of a control before it is changed by the user.

Text – Text that appears on a control or that the user types into a control.

Additional properties

Align – The location of text in relation to the horizontal center of its control.

BorderColor – The color of a control's border.

BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – The thickness of a control's border.

FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color – The color of text in a control.

DelayOutput – When set to true, user input is registered after half a second delay. Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

Disabled – Whether the user can interact with the control.

DisabledBorderColor – The color of a control's border if the control's Disabled property is set to true.

DisabledColor – The color of text in a control if its Disabled property is set to true.

DisabledFill – The background color of a control if its Disabled property is set to true.

Fill – The background color of a control.

Font – The name of the family of fonts in which text appears.

FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Height – The distance between a control's top and bottom edges.

HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – Whether the text in a control is italic.

LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength – The number of characters that the user can type into a text-input control.

Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Reset – Whether a control reverts to its default value.

Size – The font size of the text that appears on a control.

Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – Whether a line appears under the text that appears on a control.

Visible – Whether a control appears or is hidden.

Width – The distance between a control's left and right edges.

X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Related functions

DateTimeValue( String )

Examples

Collect data

  1. Add two text-input controls, and name them inputFirst and inputLast.

    Don't know how to add, name, and configure a control?

  2. Add a button, set its Text property to Add, and set its OnSelect property to this formula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Want more information about the Collect function or other functions?

  3. Add a text gallery in portrait/vertical orientation, set its Items property to Names, and set the Text property of Subtitle1 to ThisItem.FirstName.

  4. (optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.

  5. Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.

  6. (optional) Add more names to the collection, and then press Esc to return to the default workspace.

Prompt for a password

  1. Add a text-input control, name it inputPassword, and set its Mode property to Password.

  2. Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Want more information about the If function or other functions?

  3. Press F5, and then type P@ssw0rd in inputPassword.

    When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. To return to the default workspace, press Esc.

  5. (optional) Add a control such as an arrow, configure it to navigate to another screen, and show it only after the user types the password.

  6. (optional) Add a button, configure its Text property to show Sign in, add a timer, and disable the input-text control for a certain amount of time if the user types the wrong password and then clicks or taps the Sign in button.