chrome:shell.skip

generated:catalog.entry.badge.title

generated:catalog.entry.badge.description

@xngui/components/badge
@xngui/components/badge

chrome:demo.section

chrome:demo.preview

demo-preview:badge.new
demo-preview:hints.category.assistive:
TipSR
demo-preview:projection.slots-label:
[xStart] ng-content [xEnd]
import { Component } from '@angular/core';
import { XBadge } from '@xngui/components/badge';
 
@Component({
selector: 'app-example',
imports: [XBadge],
templateUrl: './badge.component.html',
})
export class ExampleComponent {}

chrome:demo.events.title

chrome:demo.events.empty

chrome:demo.api.title

x-badge

chrome:demo.api.col.property
chrome:demo.api.col.type
chrome:demo.api.col.default
chrome:demo.api.col.description
size
XSize
—
Visual size tier — falls back to XConfigService when unset.
density
XDensity
—
Spacing offsets — falls back to XConfigService when unset.
variant
XVariant
—
Semantic color role for the badge surface — falls back to XConfigService when unset.
appearance
XAppearance
—
Fill style — falls back to XConfigService when unset.
label
string
—
Pill text — omit or leave empty for dot mode when `dot` is unset.
dot
boolean
—
Force dot mode (`true`) or pill shell (`false`) — auto when unset from `label`.
ariaLabel
string
—
Accessible name when the badge renders as a dot.
pulse
boolean
false
Applies a pulsing animation on the dot or label surface.