Saltar al contenido principal
Neural UIv2.0.0Documentación
Ver v1 GitHub

Badge

Muestra un estado compacto y legible con contenido proyectado.

Categoría
Estados y avisos
Import
@neural-ui/core/badge
Selector
neu-badge
import { NeuBadgeComponent } from '@neural-ui/core/badge';

Uso

Badge recibe la etiqueta mediante contenido proyectado, no mediante un Input value. tone expresa la intención semántica y variant elige soft u outline. size controla la compacidad, pill las esquinas redondeadas y dot añade un indicador decorativo de estado. No funciona como un contador de notificaciones anclado a otro elemento.

Ejemplos

Prueba el ejemplo y abre Código para ver la implementación completa. Reiniciar restablece el estado inicial del ejemplo.

Ejemplos
BorradorAprobadoEn revisiónPendienteRechazado
BorradorAprobadoEn revisiónPendienteRechazado

Prueba y configura

Cambia las opciones y revisa la vista previa. El template generado permanece junto a los controles; Código contiene el ejemplo ejecutable completo.

Prueba y configura

Vista previa

Borrador

Template generado: refleja las opciones anteriores. Abre Código para ver los imports y el estado completos.

template.html
<neu-badge
  tone="neutral"
  variant="soft"
  size="md"
  [dot]="false"
  [pill]="true"
>
  Borrador
</neu-badge>

Datos y contenido

La aplicación proporciona los Inputs y controla la interacción del entorno. Este componente no tiene modelos ni Outputs. La proyección de contenido y los templates de iconos se documentan por separado cuando existen.

Accesibilidad y teclado

Incluye siempre texto visible significativo. Un punto o un color por sí solos no explican el estado. Badge no es interactivo ni recibe foco con teclado; utiliza un botón si el usuario debe cambiar o filtrar el estado. Añade una región de estado externa solo cuando sea necesario anunciar una actualización.

Tecla
Acción
— Sin interacción de teclado propia; los botones y enlaces proyectados conservan su comportamiento de teclado.

API

Todos los Inputs públicos se extraen del paquete Core fijado. Los tipos con nombre enlazan con sus definiciones. Solo se enumeran las zonas de proyección y los templates públicos reales.

Inputs

Configura el componente con [propiedad]="valor". Tu aplicación proporciona estos valores; el componente no debe reemplazar el estado que le pasas.

Nombre
Tipo
Por defecto
Uso en el template
Descripción
dotbooleanfalse[dot]Añade un punto decorativo antes de la etiqueta proyectada.
pillbooleantrue[pill]Esquinas completamente redondeadas.
sizeNeuBadgeSize'md'[size]Tamaño compacto sm o predeterminado md.
toneNeuBadgeTone'neutral'[tone]Intención semántica del estado.
variantNeuBadgeVariant'soft'[variant]Fondo soft o borde outline transparente.

Templates

ng-content proyecta contenido dentro del componente. Los inputs TemplateRef reciben un template; las directivas ng-template identifican templates con un contexto tipado. Una directiva compartida en el entrypoint no es necesariamente un slot de este componente.

Nombre
Mecanismo
Contrato
*

Etiqueta de estado

Ver ejemplo
Proyección de contenido

Explica el estado con texto visible, no solo mediante color.

<ng-content />

Contexto utilizado: —

Cada ejemplo muestra un template diferente. Alterna entre Demo y Código para consultar su implementación, imports y estado.

Proyección de contenido

*

Proyección de contenido
3 mensajesServicio disponible

Public Types

Abre un tipo para consultar su definición y los campos de sus interfaces.

Estilos y tokens

El tono utiliza superficies semánticas y texto legible; outline mantiene el fondo transparente. size y pill son los controles públicos de forma. Comprueba todos los tonos en ambos temas y conserva el texto aunque actives dot.

Tokens específicos

Este componente utiliza tokens compartidos del tema en lugar de tokens específicos.

Tokens compartidos utilizados

Sobrescríbelos en un contenedor local para afectar a este ejemplo. Una modificación en :root afecta a los demás componentes que utilizan el mismo token.

Token
Efecto aquí
Otros efectos
Valor / alternativa
--neu-border Bordes normales de controles y celdas Compartido con otros consumidores de Core; limita el cambio a un ámbito. rgba(15, 23, 42, 0.08)
--neu-error Color del campo no válido o de la acción de peligro Compartido con otros consumidores de Core; limita el cambio a un ámbito. #dc2626
--neu-error-bg Fondo de estados de error o peligro Compartido con otros consumidores de Core; limita el cambio a un ámbito. #fee2e2
--neu-radius Radio de las esquinas del control Compartido con otros consumidores de Core; limita el cambio a un ámbito. 8px
--neu-surface Superficie principal del campo, cabecera o control Compartido con otros consumidores de Core; limita el cambio a un ámbito. #ffffff
--neu-surface-2 Superficies secundarias y filas alternas Compartido con otros consumidores de Core; limita el cambio a un ámbito. #f1f5f9
--neu-text Color del texto principal y de los iconos que lo heredan Compartido con otros consumidores de Core; limita el cambio a un ámbito. #0f172a
--neu-text-disabled Texto de los controles deshabilitados Compartido con otros consumidores de Core; limita el cambio a un ámbito. #64748b