/v1.0

ReadOnlyNumberField

ReadOnlyNumberField renderiza un valor numérico como salida no editable. Soporta strings opcionales de prepend y append para agregar unidades, símbolos de moneda o cualquier decorador alrededor del número. Se usa en pantallas de detalle y visualización.

Props

| Prop | Tipo | Requerido | Por defecto | Descripción | |------|------|-----------|-------------|-------------| | value | number | Sí | — | El valor numérico a mostrar. Muestra 0 cuando es falsy. | | label | string | No | — | Etiqueta mostrada encima del valor. | | description | string | No | — | Texto de ayuda mostrado debajo del valor en cursiva. | | placeholder | string | No | — | Aceptado pero no renderizado (reservado para consistencia de API). | | prepend | string | No | — | Texto renderizado antes del número (ej. "$", "USD"). | | append | string | No | — | Texto renderizado después del número (ej. "kg", "%"). | | containerStyle | React.CSSProperties | No | — | Estilos personalizados para el div contenedor externo. | | valueStyle | React.CSSProperties | No | — | Estilos personalizados para el cuadro de visualización del valor. | | labelStyle | React.CSSProperties | No | — | Estilos personalizados para el elemento de etiqueta. | | descriptionStyle | React.CSSProperties | No | — | Estilos personalizados para el texto de descripción. | | prependStyle | React.CSSProperties | No | — | Estilos personalizados para el elemento de prefijo. | | appendStyle | React.CSSProperties | No | — | Estilos personalizados para el elemento de sufijo. |

Uso

Básico

import ReadOnlyNumberField from '@/components/read-only-fields/ReadOnlyNumberField';

<ReadOnlyNumberField
  label="Cantidad"
  value={42}
/>

Con prefijo de moneda

<ReadOnlyNumberField
  label="Precio total"
  value={1500}
  prepend="$"
/>

Con sufijo de unidad

<ReadOnlyNumberField
  label="Peso"
  value={75}
  append="kg"
  description="Peso neto del envío."
/>