Skip to content

Capture free-form string tokens and keep rejected-entry feedback in application state.

import { BbTag } from 'bitboss-ui';

On this page

Use it for

Use BbTag when users invent the values, such as recipients, skills, or issue labels.

Use something else when

  • BbSelect in multiple mode — values come from a known set
  • BbBadge — tokens are only displayed

Pass Through

Hover or tap a part to outline it. Toggles flip loading, errors and warnings when the component has them — only parts highlight.

$accessibilitydesign systemUSDGuidance while the control is focused.

Invite recipients with feedback

Seed a string[] model and show feedback for values rejected by the cap or duplicate check.

marta.villoresi@vantera.iolukas.brandt@vantera.io

2 of 5 invited

duplicate and max report the refused string but render no message. Put application wording in warnings or a toast.

Coming from v2

modelValue is now strictly string[]; object arrays no longer compile. The removed multiple prop was always true, so delete it.

Commit and normalize entries

divider chooses the commit key. Add comma only when commas cannot belong inside a valid token.

bugneeds-triageSeparate labels with a comma, or press Enter.

bug · needs-triage

Entries are trimmed. Duplicate matching is case-insensitive in v3; use case-sensitive only when case changes identity.

Edit tokens without a pointer

With an empty input, Backspace highlights then removes, arrows move between chips, Home/End jump, and Escape returns to typing.

TypeScriptVueNuxtLaravelEmpty field: Backspace highlights, Backspace again removes, arrows move, Escape returns to typing.

4 skills listed

Keep instructions in a hint when the workflow depends on keyboard editing. The input retains DOM focus and announces the highlighted chip.

Validate and lock the field

required is satisfied by the first token. Compute larger minimums yourself and pass the message through errors.

Add at least one keyword.
vantera.iovantera.devChecking these against the registry…
accessibilitydesign systemdocumentation

loading is only status and does not lock editing. Use readonly for a set people may copy, disabled to remove it from the tab order, and clearable only when deleting the whole array is expected.

comma is a compact display mode with no per-chip remove buttons. For read-only tokens outside a field, render BbBadge instead.