Text inputs

Quick Decision Rules

• Use TextField for generic single-line text.
• Use TextArea for multiline prose.
• Use PasswordField for masked secret entry.
• Use NumberField for exact numeric values with stepping or bounds.
• Use PhoneField for country-aware phone entry.
• Use PinField for short fixed-length verification codes.

By Value Model

• Generic single-line text: TextField
• Multiline text: TextArea
• Secret string: PasswordField
• Numeric quantity: NumberField
• Phone number: PhoneField
• OTP or PIN code: PinField

Common Misclassifications

• Do not use TextField once masking, phone parsing, number stepping, or secret reveal become part of the field contract.
• Do not use TextArea for short single-line values.
• Do not use NumberField for identifiers or codes that only happen to contain digits.
• Do not use PinField for free-form secrets or generic text.

Supporting Pieces

• Use Label for one field label.
• Use HelperText for short field-adjacent guidance.
• Use Fieldset when several fields belong to one named group.