Interface Taga11yOptions

Debounce delay in milliseconds for dynamic suggestion requests. Default: 200. Only applies to dynamic ({ query }) mode.

Characters that trigger tag commit when typed. Defaults to [, Enter]. Accepts a single character/string or an array.

Custom deserializer for the original input's value on init and on form reset. Pairs with serialize to enable round-tripping a custom format. Returns the same SuggestionItem shape suggestions accepts: plain strings resolve labels from loaded suggestions (falling back to label === value); { label, value } objects are used as-is. Defaults to splitting on ",", trimming, and dropping empties.

When true, the component is rendered in a disabled state.

When true, only suggestions from the source can be committed. Free-text entry is rejected with an error.

Internationalisation: locale, optional direction, and partial string overrides. Init-only — ignored by settings(). Omit for built-in English with no lang/dir on the wrapper.

Optional visible label rendered above the component.

Maximum number of tags the user can select. Undefined means no limit.

Name attribute for the hidden form input. Defaults to the original input's name attribute.

Custom serializer for the hidden input value. Receives the current tag array and returns a string. Defaults to comma-joining values.

Suggestion source: static array, pre-fetched async, or dynamic callback. Omit for free-text mode with no suggestions.

Forced theme override. null (default) follows the OS preference. Use "dark" or "light" to override regardless of OS setting.