Angular Badges-Bibliothek | ng-hub-ui-badges

Semantische Angular-Badges für Status, Zähler und entfernbare Filter-Tags, mit CSS-Variablen und öffentlichen SCSS-Mixins für eigene Farbfamilien.

API-Referenz

Hier ist der vollständige Vertrag für badges: alles, was du binden, abhören, projizieren und gestalten kannst, an einem Ort gesammelt. Verdrahte, was du brauchst, und gestalte, was du willst — es ist standalone und Signals-freundlich.

Inputs

Stelle badges mit 20 Inputs ein. Binde sie wie jeden Angular-@Input.

NameTypStandardBeschreibung
variantHubBadgeVariant'solid'Visuelle Gestaltung des Badge-Gehäuses.
colorHubBadgeColor'primary'Semantische Farbfamilie. Integrierte Werte entsprechen den Token-Familien des Design-Systems, eigene Namen werden unterstützt.
sizeHubBadgeSize'md'Größenskala des Badges.
shapeHubBadgeShape'pill'Eckengestaltung des Badge-Gehäuses.
dotbooleanfalseZeigt einen vorangestellten Statuspunkt vor der Beschriftung an.
removablebooleanfalseAktiviert die Schließen-Aktion und macht das Badge zu einem entfernbaren Filter/Tag.
removeLabelstring'Remove badge'Barrierefreie Beschriftung für die Schließen-Schaltfläche.
tooltipstring''Expliziter Tooltip-Text. Ohne Angabe zeigt das Badge seinen Inhalt nur als Tooltip, wenn er gekürzt ist.
interactivebooleanfalseVerwandelt das Badge in einen interaktiven Umschalter: stellt role="button" bereit, einen Tabulator-Haltepunkt für die Tastatur und gibt bei Aktivierung das selected-Output aus.
activebooleanfalseSpiegelt den gedrückten/ausgewählten Zustand eines interaktiven Badges wider und schaltet .hub-badge--active sowie das aria-pressed-Attribut um.
dotOverlaybooleanfalseRendert den Statuspunkt als Eck-Overlay, das an der Badge-Hülle fixiert ist, anstatt als inline vorangestellten Punkt.
dotPlacementHubBadgeOverlayPlacement'top-end'Ecke, an der der Overlay-Punkt fixiert wird, wenn dotOverlay aktiviert ist (z. B. top-end, top-start, bottom-end, bottom-start).
hub-chip · selectedmodel<boolean>falsehub-chip: Zwei-Wege-selected-Zustand (gedrückt) des Chips.
hub-chip · valueunknownundefinedhub-chip: opaker Wert, der den Chip innerhalb seines umschließenden hub-chip-set identifiziert.
hub-chip · colorHubBadgeColor'primary'hub-chip: semantischer Akzent, der die Chip-Farben steuert, gemeinsam genutzt mit hub-badge.
hub-chip · disabledbooleanfalsehub-chip: deaktiviert den Chip — kein Umschalten, kein Entfernen, aus der Tab-Reihenfolge entfernt.
hub-chip · removablebooleanfalsehub-chip: aktiviert die Möglichkeit zum Verwerfen und spiegelt das Verwerf-Muster des Badges wider.
hub-chip · removeLabelstring'Remove chip'hub-chip: barrierefreies Label der Verwerf-Schaltfläche.
hub-chip-set · selectionMode'single' | 'multiple''single'hub-chip-set: ob einer (single) oder mehrere (multiple) Chips gleichzeitig ausgewählt werden können.
hub-chip-set · valuemodel<unknown>undefinedhub-chip-set: Zwei-Wege-Auswahlwert — der ausgewählte Chip-value im single-Modus oder das Array der ausgewählten Werte im multiple-Modus.

Outputs

Reagiere darauf, was badges tut — 6 Events, an die du deine Logik anknüpfen kannst.

NameTypBeschreibung
removedEventEmitter<void>Wird ausgelöst, wenn die Schließen-Aktion eines entfernbaren Badges aktiviert wird.
selectedEventEmitter<void>Wird ausgegeben, wenn ein interaktives Badge per Klick, Enter oder Space aktiviert wird.
hub-chip · selectedChangeEventEmitter<boolean>hub-chip: wird ausgegeben, sobald sich der Zwei-Wege-selected-Zustand ändert.
hub-chip · removedEventEmitter<void>hub-chip: wird ausgegeben, wenn die Verwerf-Schaltfläche aktiviert wird.
hub-chip · chipClickEventEmitter<void>hub-chip: wird bei jeder Aktivierung (Klick / Enter / Space) ausgegeben, bevor das Umschalten angewendet wird.
hub-chip-set · valueChangeEventEmitter<unknown>hub-chip-set: wird ausgegeben, sobald sich der Zwei-Wege-Auswahlwert ändert.

Templates

Mach es zu deinem — 1 Template-Slots lassen dich eigenes Markup projizieren.

NameBeschreibungBeispiel
[hubChipLeading]Projiziert ein vorangestelltes Icon oder einen Avatar in den Chip, gerendert vor dem Chip-Inhalt.<hub-chip [value]="'open'" color="success"> <i hubChipLeading class="fa-solid fa-circle" aria-hidden="true"></i> Open </hub-chip>