@gridui/tag-input

Core family. Public API: TagInput, TagInputProps, TagRejection, TagRejectionReason.

Import components from @gridui/tag-input and load these styles in order.

@import "@gridui/theme/styles.css";
@import "@gridui/button/styles.css";
@import "@gridui/input/styles.css";
@import "@gridui/form/styles.css";
@import "@gridui/tag-input/styles.css";

Input supplies the control surface, Button supplies tag actions, and Form hides the native multiple-value bridge. Applications own routes, labels, state persistence, and branding.

See component ownership and release history.

Component reference contains focused API pages for each public component.

Drafts and suggestions

draft/onDraftChange control the text being edited independently of committed value/onValueChange. Omit draft for local text, optionally initialized with defaultDraft. Reset requests the initial draft; controlled consumers can reject that request. Draft text is excluded from native form submission.

Optional suggestions accepts Autocomplete options, searchLabel, emptyLabel, filterOptions, loading/error labels and portalContainer. Load Overlay and Select styles as well as the existing family styles when using suggestions. Selecting a suggestion commits its value through normal tag validation, deduplication and limits. Unknown text still commits with Enter/comma. Highlighting a suggestion with arrows makes Enter choose it; IME confirmation never commits. onReject keeps invalid or limited candidates editable. Use onDraftChange to drive remote options. controlSize selects standard or small density. Native props/ref target the draft input; className continues to target the encompassing tag surface.