Input

A single-line text field with label, icons, help text, and validation states. It’s a form-associated custom element, so it participates in native <form> submission and validation just like a built-in input.

Install

Examples

Default

Negative

Positive

Disabled

Leading icon

Trailing icon

Required

Required + email format

Try submitting empty, then “foo”, then “a@b.com”.

Submit

Form integration

Submit & reset — all four form-associated controls participate.

Subscribe to newsletter
Plan Free Pro Team
Submit Reset
(submit to see FormData JSON)

Date

kind="date" turns the field into a Date Picker dropdown.

Date — preselected

Date — range

Date — with help text

Date — disabled

Guidelines

Usage

form fields, search inputs, email capture — any single-line text entry. For multi-line input use Text Area.

Do

  • Always give the field a clear label; use placeholder for an example, not the label.
  • Set type / inputmode (email, tel…) so mobile keyboards and validation match.
  • Explain errors in help-text with state="negative".

Don’t

  • Don’t use placeholder text as the only label — it disappears on input.
  • Don’t mark a field positive unless the success is meaningful to confirm.
  • Don’t use Input for multi-line text — use Text Area.

Accessibility

Properties

Related