UnreviewedStandard ARIA attributes describe the native input/textarea in the shadow tree and are delegated there when the element upgrades.
OptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptionalonOptional UnreviewedkeyReact/Preact reconciliation key when rendered inside a list.
Optional UnreviewedidHTML id attribute.
Optional UnreviewedclassHTML class attribute (standard DOM).
Optional UnreviewedclassReact/Preact-style class name. Alias for class.
Optional UnreviewedstyleInline styles applied to the element.
OptionalchildrenOptional UnreviewedslotAssigns the element to a named <slot> (e.g. slot="title").
Optional UnreviewedtabTab order. Set to 0 to make the element keyboard-focusable.
Optional UnreviewedroleARIA role override.
Optional UnreviewedvalueControlled value (string). Reflected to the shadow control only when it differs, so the caret survives re-renders.
Optional UnrevieweddefaultvalueInitial value for the uncontrolled case; read once on connect.
Optional UnreviewedmultilineRender a <textarea> rather than <input>. Presence-based.
Optional UnreviewedrowsFixed visible row count for a <textarea> (implies multiline).
Optional UnreviewedmaxrowsCap autogrow height (rows) for a multiline field with no rows.
Optional UnreviewedstatusValidation/feedback tone — colors the border + message and (via the
wrapper) the glyph. Only critical carries validity weight (aria-invalid
:state(invalid)); the others are advisory. Omit for the neutral field.Optional UnreviewedtoneCustom accent color (any literal CSS color) — tints the border when shown
via an oklch derivation. status overrides it for validation.
Optional UnreviewedpriorityField emphasis. Secondary removes the fill; tertiary also makes the resting border transparent. Status borders remain visible.
Optional UnrevieweddisabledDisabled state. Presence-based.
Optional UnreviewedreadonlyRead-only state. Presence-based.
Optional UnreviewedbuttonRender a native button inside the field surface. Presence-based.
Optional UnreviewedrequiredRequired — drives native validity. Presence-based.
Optional Unrevieweddim-Dim the leading/trailing adornments at rest (0.6); they brighten to full when the field is hovered or focused. Presence-based.
Optional UnreviewedroundFully-round field (border-radius: 999px), or a custom radius via a length
value (round="10px"). Presence-based for the boolean form.
Optional UnreviewedsizeSize variant. small=24px, medium (default)=28px, large=32px.
Optional UnreviewedtypeSingle-line input type (ignored when multiline). search is intentionally
unavailable — it triggers browser-injected clear/search affordances.
Optional UnreviewednameForm field name — submitted via ElementInternals.
Optional UnreviewedplaceholderPlaceholder shown when empty.
Optional UnreviewedautofocusFocus this field when its containing a-dialog opens. Presence-based.
Optional UnreviewedtruncateEllipsize an overflowing single-line value. Presence-based.
OptionalautocompleteOptionalinputmodeOptionalmaxlengthOptionalminlengthOptionalpatternOptionalminOptionalmaxOptionalstepOptionalspellcheckOptional UnreviewedoninputFires on every keystroke (input is composed — it reaches the host).
Optional UnreviewedonchangeFires on commit; the element re-dispatches the control's change on the
host (native change isn't composed).
Optional UnreviewedonclearclickFires when the built-in clear button is clicked, before clearing
(cancelable, bubbling clearclick event — preventDefault keeps the
value). All-lowercase so it binds in React and Preact.
Optional UnreviewedonclearinputFires after the field has been cleared (bubbling clearinput event).
All-lowercase so it binds in React and Preact.
Optionalaria-Optionalaria-
Attributes for the
<a-input>custom element — a form-associated text field whose real<input>/<textarea>lives in shadow DOM. For the typed JSX wrapper useInputfrom@antadesign/anta.Slots (light-DOM children):
label,leading,clear,trailing,hint. Direct trailing buttons and buttons-only<a-input-trailing slot="trailing">groups use compact spacing. Other wrappers keep the text inset. Override either inset with the--input-trailing-insetCSS property. Anta buttons fit the field height and keep their padding. CSS makes actions with one direct icon and only optional tooltip or copy helpers square. Other element children keep their natural width. Wrap visible text beside an icon ina-button-label. Other controls keep their own sizing. The element exposes::part(field | input | label | leading | clear | trailing | hint)for styling, and:state(filled)/:state(invalid)as CSS hooks.