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

MeterGroup

Muestra cómo varios valores se distribuyen sobre una capacidad de referencia.

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

Uso

Cada NeuMeterItem proporciona label, value y un color CSS opcional. Un total positivo define la capacidad; total 0 utiliza la suma de los elementos. Si total es mayor, la parte libre de la barra representa la capacidad disponible. Los valores negativos y no finitos cuentan como 0; el exceso se limita en el orden de los elementos. showLegend añade nombres y porcentajes. Es un medidor de distribución, no de progreso de una operación.

Ejemplos

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

Ejemplos

Distribución del almacenamiento

  • Documentos35%
  • Fotos25%
  • Otros10%

70 GB utilizados · 30 GB disponibles

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

  • Documentos35%
  • Fotos25%

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

template.html
<neu-meter-group
  [items]="items"
  [total]="100"
  [height]="12"
  [rounded]="true"
  [showLegend]="true"
  ariaLabel="Distribución del almacenamiento"
/>
items.ts
import type { NeuMeterItem } from '@neural-ui/core/meter-group';

const items: NeuMeterItem[] = [
  {
    "label": "Documentos",
    "value": 35
  },
  {
    "label": "Fotos",
    "value": 25
  }
];

Datos y contenido

La aplicación proporciona items y total. MeterGroup calcula la distribución mostrada sin modificar el array recibido. No tiene Outputs ni templates.

Accesibilidad y teclado

Proporciona un ariaLabel descriptivo y conserva la leyenda para explicar cada segmento sin depender del color. El medidor expone el total y el valor utilizado normalizados. Incluye las unidades y la capacidad restante en texto contiguo. No tiene interacción de teclado.

Tecla
Acción
— Proporciona un ariaLabel descriptivo y conserva la leyenda para explicar cada segmento sin depender del color. El medidor expone el total y el valor utilizado normalizados. Incluye las unidades y la capacidad restante en texto contiguo. No tiene interacción de teclado.

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
ariaLabelstring'Meter'[ariaLabel]Nombre accesible del medidor y su leyenda.
heightnumber12[height]Altura de la barra en píxeles.
itemsNeuMeterItem[][][items]Etiqueta, valor numérico y color CSS opcional de cada segmento.
roundedbooleantrue[rounded]Esquinas completamente redondeadas de la barra.
showLegendbooleantrue[showLegend]Muestra los nombres y porcentajes normalizados de los segmentos.
totalnumber0[total]Capacidad positiva de referencia; 0 utiliza la suma de los valores válidos.

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.

Este componente no expone proyección de contenido ni templates públicos de personalización.

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-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-primary Color de marca en controles activos y énfasis Compartido con otros consumidores de Core; limita el cambio a un ámbito. #007aff
--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-muted Etiquetas secundarias y contenido de ayuda Compartido con otros consumidores de Core; limita el cambio a un ámbito. #475569
--neu-meter-track Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. var(--neu-meter-track-bg)
--neu-radius-full Radio de esquina Compartido con otros consumidores de Core; limita el cambio a un ámbito. 9999px
--neu-secondary Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. #10b981
--neu-success Valor del tema heredado que utiliza este componente Compartido con otros consumidores de Core; limita el cambio a un ámbito. #15803d