pattern-library checked
U.S. Web Design System: Text input component
Defines text input as freeform letters, numbers, or symbols; recommends field widths that match expected answer length, delayed validation, avoiding placeholder-only help, and choosing alternatives for predetermined options.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Text input | Choose text input when the user enters a short freeform value such as a reference, title, identifier, one-line note, or organization name. | Typing, deleting, selection, undo, and paste operate like a native single-line text field. | USWDS guidance supports freeform text input use, delayed validation, field-width matching, paste support, placeholder cautions, and accessibility checks. |
| Textarea | Choose textarea when the expected response is more than a short single-line answer. | Typing, selection, line breaks, paste, undo, redo, and spellcheck follow native textarea behavior. | USWDS text input guidance distinguishes paragraph responses that should use a textarea rather than a one-line field. |
Evidence Role
This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: U.S. Web Design System. Last checked: .