Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

Wrap

The default: chips flow onto more lines, so every chip stays in view on a wide screen.

Wraps by default
Show code
<app-chip-group label="Status filters">…</app-chip-group>

More menu

Keep one line on a phone: chips that do not fit move into a More menu, so filters never push off screen.

Chips in a More menu
Show code
<app-chip-group label="Status filters" overflow="Menu">…</app-chip-group>

Removable tags

Give each tag a remove button, and in a More menu a tag with only a remove button is listed greyed out.

Removable tags
A chip with only a remove button has no body control, so in the menu it is listed greyed out.
Lightning IEC 62305 Zone 1 Rev B Draft
Show code
<app-chip-group overflow="Menu"><app-chip label="Lightning" removable="true"></app-chip>…</app-chip-group>

Every option

Every value of every prop, one cell each.

children: AppChip, AppChoiceChip

<app-chip>
Open In review Approved
<app-choice-chip>

overflow: wrap or menu

overflow="wrap" (default)
overflow="menu"

more-label: any string, shown with overflow menu

more-label="More" (default)
more-label="More filters"

label: any string

label="Status filters" (read aloud, not shown)

class: any string

class="extra" (React className, no visible change)

Guidance

What to do, and what to avoid.

Use it when

  • A filter or tag row that must stay on one line on a phone.
  • A row of chips of unknown length.

Reach for something else when

  • Two to four exclusive options. → AppSegmented
  • Tabs that switch panels. → AppTabs

Reference

Try every prop, read the full list, and check keyboard and screen reader behaviour.

wrap menu
React, generated from the controls
<AppChipGroup label="Status filters" overflow="menu">
  {statuses.map((s) => <AppChoiceChip key={s} checked={picked.includes(s)} onChange={() => toggle(s)}>{s}</AppChoiceChip>)}
</AppChipGroup>
Razor, the same props
<app-chip-group label="Status filters" overflow="Menu">…</app-chip-group>

3 props. The 3 most used come first.

Used on most screens 3 props

PropTypeDefaultDescription
overflowdefault wrap wrap | menu wrap wrap lets the chips wrap; menu moves the extras into a More menu.
more-labeldefault More string More The More button text when overflow is menu.
labeldefault - string - Accessible name for the group.

Screen reader

3 notes
  • The group has role group and takes its accessible name from label.
  • With overflow menu, the chips that do not fit move into a More menu whose button text is moreLabel.
  • Choosing a chip in the menu clicks that chip's own control; a chip with no control is listed greyed out.