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

StatsCard

Presenta una métrica formateada, su cambio y contexto adicional.

Categoría
Diseño y contenido
Import
@neural-ui/core/stats-card
Selector
neu-stats-card
import { NeuStatsCardComponent } from '@neural-ui/core/stats-card';

Uso

Proporciona title y value ya formateado. change es texto de presentación, no un porcentaje calculado. trend añade un indicador ascendente, descendente o neutro. label aporta contexto y el contenido proyectado aparece en el pie. icon resuelve un icono de la aplicación. Explica con palabras si una subida o bajada de la métrica resulta favorable.

Ejemplos

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

Ejemplos
Pedidos
1.248
Devoluciones
24
Conversión
4,2%

Prueba y configura

Cambia las opciones y consulta la vista previa y el template generado. Código contiene el ejemplo ejecutable completo.

Prueba y configura

Vista previa

Pedidos completados
1.248

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

template.html
<neu-stats-card
  title="Pedidos completados"
  value="1.248"
  change="+12%"
  trend="up"
  label="Respecto al mes anterior"
/>

Datos y contenido

La aplicación formatea los valores y calcula los cambios. StatsCard no tiene Outputs, modelos ni API de formato numérico. Los botones del contenido proyectado gestionan sus propios eventos.

Accesibilidad y teclado

Da a cada métrica un título visible y explica el periodo de comparación. Los iconos de tendencia son decorativos; change y el contexto comunican el resultado. La tarjeta no es un botón. Proyecta un enlace o botón real para consultar detalles.

Tecla
Acción
— Da a cada métrica un título visible y explica el periodo de comparación. Los iconos de tendencia son decorativos; change y el contexto comunican el resultado. La tarjeta no es un botón. Proyecta un enlace o botón real para consultar detalles.

API

Los Inputs y Outputs se extraen del paquete fijado. Los tipos con nombre enlazan a sus definiciones; Templates enumera solo las zonas de proyección disponibles.

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
changestring''[change]Texto de comparación ya formateado; no realiza cálculos.
iconstring | nullnull[icon]Clave opcional de un icono resuelto por la aplicación.
labelstring''[label]Contexto adicional, como el periodo de comparación.
titlestring''[title]Nombre visible de la métrica.
trendNeuStatsTrend'neutral'[trend]Dirección up, down o neutral; explica su significado con texto.
valuestring''[value]Valor ya formateado que se muestra como texto.

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
*

Pie de la métrica

Ver ejemplo
Proyección de contenido

Añade contenido complementario o un botón para consultar detalles.

<ng-content />

Contexto utilizado: —

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

Acciones del pie de la métrica

*

Acciones del pie de la métrica
Pedidos completados
248

Public Types

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

Estilos y tokens

Utiliza los Inputs públicos y los tokens de superficie, texto, espaciado y color semántico de Core. Mantén el contenido adaptable y comprueba ambos temas.

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-bg Fondo de estados de error o peligro Compartido con otros consumidores de Core; limita el cambio a un ámbito. #fee2e2
--neu-error-text Texto de error y de Button danger outline/ghost en ambos temas Compartido con otros consumidores de Core; limita el cambio a un ámbito. #991b1b
--neu-primary Color de marca en controles activos y énfasis Compartido con otros consumidores de Core; limita el cambio a un ámbito. #007aff
--neu-primary-50 Superficie tenue de marca para estados de puntero y foco Compartido con otros consumidores de Core; limita el cambio a un ámbito. #eff6ff
--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