vocab.design

component · forms

Text field

also called text input (govuk), textbox (nngroup), input field (community), form field (community)

A single line box for typed input, carrying a label, an optional hint, and the error message shown when what was typed does not pass.

A text field is the whole assembly, not just the box. The word names four parts that travel together: the label that says what to type, the control that takes the typing, the hint that heads off the likely mistake, and the message that explains a value the field would not accept. Every design system that ships this component ships all four, which is why “text field” is the useful unit of vocabulary and “the input” is not.

The label stays visible. A placeholder is not a label: it vanishes the moment someone starts typing, exactly when the reminder is wanted, and it is read late or not at all by some screen readers. Put the format guidance in the hint, above or below the box but always present, and keep the error for the value that actually failed. Width is information too: a field sized for a postcode tells the reader how much is expected, so size the box to the content rather than to the column it sits in.

The line count is the boundary. One line is a text field; more than one is a text area, and the two are not interchangeable, because a single line box silently hides the middle of a long value. A field that offers a list of values as you type is a combobox, and one that returns results rather than storing a value is a search field. What separates them is not the look (all three are a box you type into) but what the typing is for.

Names differ more than the component does. HTML calls the element input, but <input> also produces checkboxes, radios, and sliders, so “input field” describes the tag rather than the concept. “Form field” is looser still: it names any slot in a form, including selects and checkboxes. “Textbox” comes from the ARIA role of the same name and is common in usability writing. In code, expect TextField in Material, Polaris, and Radix Themes, Text input in Carbon and GOV.UK, and a bare Input in Fluent, Base UI, and shadcn/ui.

Which word?

If you wantsay
one line of free text or a numbertext field
input that runs to several linestext area
entering a short code one character per boxpin input
a unit, prefix or action belongs inside the fieldinput group

Related

Variants: Search field

Contains: Character counter · Error message · Floating label · Helper text · Password reveal toggle

Implementations

Specimens illustrate the concept; for production use, start here.

materialText fields
higText fields
fluentInput
carbonText input
polarisText field
radixText Field
base-uiInput
shadcnInput

Sources