ComponentsInput

formstexulinot agent-emittableapp

Input

input

A single-line text (or file) control with optional clear.

Live examples

Text input

Text input

Loading demo…

Email input

Email input

Props

Public props for Input
NameKindRequiredDefaultDescription
typestringno"text"Native input type
valuestringno—Controlled value (bind:value)
filesunknownno—FileList when type=file (bind:files)
refunknownno—Element ref for the native input
clearablebooleannofalse—
clearLabelstringno"Clear"—
disabledbooleannofalse—
readonlybooleannofalse—
onValueChangeeventno——
onCleareventno——
classstringno——

Keyboard

Keyboard behavior for Input
KeyAction
—See accessibility notes for keyboard behavior.

Accessibility

  • Pair with Field or an external label via id/for
  • Clear control has an accessible name when clearable

Evidence for input

Latest committed gates for input (as of 2026-10-23). Static snapshot — not live CI.

Behavior

n/ano behavior scenario

No dedicated behavior scenario for this catalog id (a styled or display surface, covered by its unit and axe tests).

Size (gzip)

texuli/input · budget 12.0 KiB

Budget from texuli.budgets.json; re-measure with `pnpm size --filter <entry>`.

Axe

documented

  • tests/e2e/site-component-pages.spec.ts
  • docs/quality (a11y-*)

Site component pages axe gate; package-level a11y docs under docs/quality when present.

Browsers

  • chromium
  • webkit
  • mobile

Playwright projects: Desktop Chrome, Desktop Safari, Pixel 7. Firefox is a known gap on this host.

When to use

Use when

  • Short free-text fields
  • Native file selection

Don’t use when

Prefer another component

  • Multi-line text (use textarea)
  • A labeled field with description and error (wrap in field)