Библиотека бейджей для Angular | ng-hub-ui-badges

Семантические бейджи Angular для статусов, счётчиков и удаляемых тегов фильтров, с CSS-переменными и публичными SCSS-миксинами для собственных цветовых семейств.

Справочник API

Вот полный контракт badges: всё, что можно привязать, прослушать, спроецировать и тематизировать, собрано в одном месте. Подключите то, что нужно, и оформите так, как хотите — это standalone и дружит с сигналами.

Входные свойства

Настройте badges с помощью 20 входных свойств. Привязывайте их, как любой @Input в Angular.

ИмяТипПо умолчаниюОписание
variantHubBadgeVariant'solid'Визуальное оформление оболочки бейджа.
colorHubBadgeColor'primary'Семантическое семейство цветов. Встроенные значения соответствуют семействам токенов дизайн-системы; поддерживаются и пользовательские имена.
sizeHubBadgeSize'md'Шкала размеров бейджа.
shapeHubBadgeShape'pill'Оформление углов оболочки бейджа.
dotbooleanfalseОтображает точку статуса перед подписью.
removablebooleanfalseВключает действие закрытия, превращая бейдж в удаляемый фильтр/тег.
removeLabelstring'Remove badge'Доступная подпись для кнопки закрытия.
tooltipstring''Явный текст подсказки. Если не задан, бейдж показывает своё содержимое как подсказку только при усечении.
interactivebooleanfalseПревращает бейдж в интерактивный переключатель: предоставляет role="button", точку остановки при табуляции с клавиатуры и испускает output selected при активации.
activebooleanfalseОтражает нажатое/выбранное состояние интерактивного бейджа, переключая .hub-badge--active и атрибут aria-pressed.
dotOverlaybooleanfalseОтрисовывает точку состояния как угловое наложение, прикреплённое к оболочке бейджа, вместо встроенной ведущей точки.
dotPlacementHubBadgeOverlayPlacement'top-end'Угол, к которому прикрепляется точка-наложение, когда включён dotOverlay (например, top-end, top-start, bottom-end, bottom-start).
hub-chip · selectedmodel<boolean>falsehub-chip: двусторонне связанное selected (нажатое) состояние чипа.
hub-chip · valueunknownundefinedhub-chip: непрозрачное value, идентифицирующее чип внутри охватывающего его hub-chip-set.
hub-chip · colorHubBadgeColor'primary'hub-chip: семантический акцент, задающий цвета чипа, общий с hub-badge.
hub-chip · disabledbooleanfalsehub-chip: отключает чип — без переключения, без удаления, исключается из порядка табуляции.
hub-chip · removablebooleanfalsehub-chip: включает возможность удаления, повторяя паттерн удаления бейджа.
hub-chip · removeLabelstring'Remove chip'hub-chip: доступная метка кнопки удаления.
hub-chip-set · selectionMode'single' | 'multiple''single'hub-chip-set: можно ли выбрать один (single) или несколько (multiple) чипов одновременно.
hub-chip-set · valuemodel<unknown>undefinedhub-chip-set: двусторонне связанное значение выбора — value выбранного чипа в режиме single или массив выбранных значений в режиме multiple.

События

Реагируйте на то, что делает badges, — 6 событий, к которым можно подключить вашу логику.

ИмяТипОписание
removedEventEmitter<void>Срабатывает при активации действия закрытия у удаляемого бейджа.
selectedEventEmitter<void>Испускается при активации интерактивного бейджа щелчком, клавишей Enter или Space.
hub-chip · selectedChangeEventEmitter<boolean>hub-chip: испускается при каждом изменении двусторонне связанного состояния selected.
hub-chip · removedEventEmitter<void>hub-chip: испускается при активации кнопки удаления.
hub-chip · chipClickEventEmitter<void>hub-chip: испускается при каждой активации (click / Enter / Space), до применения переключения.
hub-chip-set · valueChangeEventEmitter<unknown>hub-chip-set: испускается при каждом изменении двусторонне связанного значения выбора.

Шаблоны

Сделайте его своим — 1 слотов шаблона позволяют проецировать собственную разметку.

ИмяОписаниеПример
[hubChipLeading]Проецирует ведущую иконку или аватар в чип, отрисовываемые перед содержимым чипа.<hub-chip [value]="'open'" color="success"> <i hubChipLeading class="fa-solid fa-circle" aria-hidden="true"></i> Open </hub-chip>