Librería de badges para Angular | ng-hub-ui-badges

Badges semánticos para Angular orientados a estados, contadores y tags removibles, con variables CSS y mixins SCSS públicos para familias de color personalizadas.

Referencia API

Aquí tienes el contrato completo de badges: todo lo que puedes enlazar, escuchar, proyectar y personalizar, reunido en un solo sitio. Enlaza lo que necesites y dale el estilo que quieras — es standalone y reactivo con signals.

Inputs

Ajusta badges a tu gusto con 20 inputs. Se enlazan como cualquier @Input de Angular.

NombreTipoPor defectoDescripción
variantHubBadgeVariant'solid'Tratamiento visual de la carcasa del badge.
colorHubBadgeColor'primary'Familia de color semántica. Las variantes integradas mapean a las familias de tokens del design system y también se admiten nombres personalizados.
sizeHubBadgeSize'md'Escala de tamaño del badge.
shapeHubBadgeShape'pill'Tratamiento de esquinas de la carcasa del badge.
dotbooleanfalseRenderiza un dot de estado al inicio antes de la etiqueta.
removablebooleanfalseActiva la acción de cierre y convierte el badge en un filtro/tag removible.
removeLabelstring'Remove badge'Etiqueta accesible aplicada al botón de cierre.
tooltipstring''Texto explícito del tooltip. Si se omite, el badge muestra su propio contenido como tooltip solo cuando está truncado.
interactivebooleanfalseConvierte el badge en un interruptor interactivo: expone role="button", una parada de tabulación de teclado y emite el output selected al activarse.
activebooleanfalseRefleja el estado pulsado/seleccionado de un badge interactivo, alternando .hub-badge--active y el atributo aria-pressed.
dotOverlaybooleanfalseRenderiza el punto de estado como una superposición de esquina anclada al contenedor del badge en lugar del punto inicial en línea.
dotPlacementHubBadgeOverlayPlacement'top-end'Esquina a la que se ancla el punto superpuesto cuando dotOverlay está habilitado (p. ej. top-end, top-start, bottom-end, bottom-start).
hub-chip · selectedmodel<boolean>falsehub-chip: estado selected (pulsado) del chip con enlace bidireccional.
hub-chip · valueunknownundefinedhub-chip: valor opaco que identifica el chip dentro de su hub-chip-set contenedor.
hub-chip · colorHubBadgeColor'primary'hub-chip: acento semántico que rige los colores del chip, compartido con hub-badge.
hub-chip · disabledbooleanfalsehub-chip: deshabilita el chip — sin conmutación, sin eliminación, retirado del orden de tabulación.
hub-chip · removablebooleanfalsehub-chip: habilita la posibilidad de descarte, replicando el patrón de descarte del badge.
hub-chip · removeLabelstring'Remove chip'hub-chip: etiqueta accesible del botón de descarte.
hub-chip-set · selectionMode'single' | 'multiple''single'hub-chip-set: si puede seleccionarse uno (single) o varios (multiple) chips a la vez.
hub-chip-set · valuemodel<unknown>undefinedhub-chip-set: valor de selección con enlace bidireccional — el value del chip seleccionado en modo single, o el array de valores seleccionados en modo multiple.

Outputs

Reacciona a lo que hace badges: 6 eventos a los que enganchar tu lógica.

NombreTipoDescripción
removedEventEmitter<void>Se emite cuando se activa la acción de cierre de un badge removible.
selectedEventEmitter<void>Emitido cuando un badge interactivo se activa mediante clic, Enter o Space.
hub-chip · selectedChangeEventEmitter<boolean>hub-chip: emitido cada vez que cambia el estado selected bidireccional.
hub-chip · removedEventEmitter<void>hub-chip: emitido cuando se activa el botón de descarte.
hub-chip · chipClickEventEmitter<void>hub-chip: emitido en cada activación (clic / Enter / Space), antes de aplicar la conmutación.
hub-chip-set · valueChangeEventEmitter<unknown>hub-chip-set: emitido cada vez que cambia el valor de selección bidireccional.

Templates

Hazlo tuyo — 1 plantillas para proyectar tu propio marcado.

NombreDescripciónEjemplo
[hubChipLeading]Proyecta un icono o avatar inicial en el chip, renderizado antes del contenido del chip.<hub-chip [value]="'open'" color="success"> <i hubChipLeading class="fa-solid fa-circle" aria-hidden="true"></i> Open </hub-chip>