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 7 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.

Outputs

Reacciona a lo que hace badges: 1 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.

Templates

Todavía no hay templates documentados.

Variables CSS

Personaliza cada detalle con 14 variables CSS. Sobrescríbelas en :root o acótalas a un contenedor.

Disposición y espaciado

Tokens de tipografía, padding, radio y separación interna para la carcasa del badge.

VariablePor defectoTipoDescripción
--hub-badge-font-size0.875remlength Tamaño de fuente base del badge. 0.75rem1rem
--hub-badge-padding-x0.625remlength Relleno horizontal interno del badge. 0.5rem0.875rem
--hub-badge-padding-y0.375remlength Relleno vertical interno del badge. 0.25rem0.5rem
--hub-badge-border-radius50remlength Radio de las esquinas del badge. 0.25rem9999px
--hub-badge-gap0.375remlength Espacio entre el punto, los iconos, la etiqueta y el botón de cierre. 0.25rem0.5rem
--hub-badge-directionrowstring Dirección flex del contenido del badge (icono proyectado, etiqueta y botón de cierre). rowrow-reverse
--hub-badge-aligncenterstring Alineación en el eje transversal del contenido del badge. centerbaseline

Roles de color semánticos

Roles de accent, subtle, emphasis y border derivados de la familia semántica seleccionada.

VariablePor defectoTipoDescripción
--hub-badge-accentvar(--hub-sys-color-primary)color Acento semántico raíz del que el badge deriva su aspecto. var(--hub-sys-color-success)#7c3aed
--hub-badge-accent-subtlevar(--hub-sys-color-primary-subtle)color Superficie tintada usada por las variantes soft y subtle. #e7f1ff#ede9fe
--hub-badge-accent-emphasisvar(--hub-sys-color-primary-emphasis)color Color de énfasis usado por las variantes outline, ghost y soft. #0a58ca#5b21b6
--hub-badge-accent-bordervar(--hub-sys-color-primary-border-subtle)color Rol de borde usado por las variantes subtle y surface. #9ec5fe#c4b5fd

Dot y acción de cierre

Tokens que gobiernan el tamaño del dot de estado y la affordance de cierre.

VariablePor defectoTipoDescripción
--hub-badge-dot-size0.5remlength Diámetro del punto de estado opcional. 0.375rem0.625rem
--hub-badge-remove-size1remlength Tamaño del área de pulsación del botón de cierre. 0.875rem1.25rem
--hub-badge-remove-hover-bgcolor-mix(in srgb, currentColor 12%, transparent)color Superficie en hover del botón de cierre. rgba(0,0,0,.08)transparent

Estilos y theming

Todavía no hay ejemplos de estilos documentados. Esta sección incluirá recetas de personalización y ejemplos de theming.