Skip to content

Chip โ€‹

A small status or label chip. Slot any content inside โ€” text, count, icon. Toggle Vue / CSS to switch the live demo and source together.

Basic โ€‹

Five color variants with the default soft style.

Vue SFC

Sizes โ€‹

xs, sm, md, lg, xl, xxl.

Vue SFC

Variants โ€‹

Soft, solid and outline across two colors.

Vue SFC

Shapes โ€‹

Pill, rounded and square corners.

Vue SFC

Dot โ€‹

Status dot indicator next to the label.

Vue SFC

Icon โ€‹

Slot an icon on the left or right of the label.

Vue SFC

Interactive โ€‹

Clickable, selected, disabled and removable states.

Vue SFC

Renders as <a> when href is set.

Vue SFC

Event: click โ€‹

Listen for the mno-click event on a clickable chip.

Vue SFC

Event: toggle โ€‹

Two-way binding to a clickable chip's selected state.

Vue SFC

Event: remove โ€‹

Remove items from a list when their close button fires mno-close.

Vue SFC

Event: group โ€‹

Multi-select chip group; clicks toggle each chip.

Vue SFC

Event log โ€‹

Live log of mno-click and mno-close events.

Vue SFC

Customized โ€‹

Override per-element styling with the cssClass prop (Vue) or extra utility classes (CSS).

Vue SFC

CSS Variables โ€‹

Vue SFC

Every chip is themed through --mono-chip-* custom properties. Setting one on the element, on any wrapper/ancestor, or inline all work โ€” custom properties inherit, and they pierce the shadow-DOM boundary, so the same overrides apply to <mono-chip> and the shadow build. Override a base color (e.g. --mono-chip-primary) and its soft/solid/outline/hover tints all derive from it automatically. To re-skin globally, set the underlying --theme-* tokens.

VariableDefaultControls
--mono-chip-primary--theme-primaryPrimary chip color (soft/solid/outline derive)
--mono-chip-secondary--theme-secondarySecondary chip color
--mono-chip-success--theme-successSuccess chip color
--mono-chip-danger--theme-dangerDanger chip color
--mono-chip-warning--theme-warningWarning chip color
--mono-chip-info--theme-infoInfo chip color
--mono-chip-teal--theme-tealTeal chip color
--mono-chip-purple--theme-purplePurple chip color
--mono-chip-neutral--theme-neutralNeutral chip color
--mono-chip-dark--theme-darkDark chip color
--mono-chip-font-weight--theme-font-weight-mediumLabel weight

Each color also exposes --mono-chip-<color>-soft and --mono-chip-<color>-lite for the soft-fill and border/hover tints, should you want to override those independently.

Types โ€‹

Importimport { MonoChipProps } from 'mono-helper'
PropValueDefaultDescription
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'โ€”Sizing scale of the chip.
color'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'teal' | 'purple' | 'dark' | 'neutral'โ€”Color theme applied to the chip.
variant'solid' | 'outline' | 'soft'โ€”Visual style: soft, solid, or outline.
shape'square' | 'pill' | 'rounded'โ€”Corner style: pill, rounded, or square.
labelstringโ€”Text content shown inside the chip.
dotbooleanโ€”Shows a status dot before the label.
removablebooleanโ€”Adds a close button to remove the chip.
disabledbooleanโ€”Disables interaction and dims the chip.
clickablebooleanโ€”Makes the chip clickable and toggleable.
modelValuebooleanโ€”Two-way bound selected state of the chip.
selectedbooleanโ€”Whether the chip is in the selected state.
hrefstringโ€”Renders the chip as a link to this URL.
targetstringโ€”Link target when an href is set.
iconPosition'left' | 'right'โ€”Recommended JS/TS prop.
ariaLabelTextstringโ€”Recommended JS/TS prop.
ariaLabelstringโ€”Shorter alias.
closeLabelstringโ€”Recommended JS/TS prop.
cssClassChipCssClassโ€”Per-element class overrides for internal parts.