Arc Rider Docs · Markdown

Mini Widgets

Custom NumPad

Numpad en React

Introduce números mediante un teclado en pantalla, por ejemplo cantidades o importes. El resultado se mantiene primero como un string formateado.

Referencia para @arcrider/arcwidgets-react@0.1.0-alpha.5. <a href="/docs/react/intro/setup-react">Instalación</a> · <a href="/docs/react/intro/react-components">Todos los componentes</a>.

Ejemplo completo

Props del componente

id

ID de DOM opcional. No es necesario en el uso normal; se genera automáticamente si se omite.

data

Configuración de tipo ArcWidgetNumpadData. Pasa los cambios como objetos nuevos; gestiona los datos de negocio y la selección en el estado de React.

onAction

Fallback opcional (type: string, ...args: unknown[]) => unknown. El callback concreto tiene prioridad. Detalles: <a href="/docs/react/patterns/react-state-events">Estado y eventos</a>.

onSubmit

El usuario ha confirmado. value es un string numérico con punto decimal y sin ceros finales, p. ej. "12.5"; una entrada vacía da "0".

onSubmit?: (value: string) => void;

Configuración

Los siguientes campos pertenecen a data. Los tamaños se indican como strings, los números y valores de tiempo según su tipo respectivo.

currentValue

Valor inicial con punto o decimalSeparator como marca decimal, p. ej. 12.5 o "12,5".

Tipo: string | number.

actionTitle

Etiqueta del botón de confirmar. Valor por defecto: Submit.

Tipo: string.

backgroundColor

Color de las teclas y del botón de confirmar; los colores hexadecimales reciben además un estado pulsado más claro. Valor por defecto: #007bff.

Tipo: string.

fontColor

Color del texto de las teclas y del botón de confirmar. Valor por defecto: #ffffff.

Tipo: string.

display

Visualización del valor encima de las teclas: fontColor (por defecto #000000) y height como altura máxima.

Tipo: ArcWidgetNumpadDisplay.

suffix

Unidad que se muestra tras el valor, p. ej. "kg".

Tipo: string.

clearOnFirstInput

Reemplaza currentValue con el primer dígito tecleado en lugar de añadirlo. Valor por defecto: false.

Tipo: boolean.

decimalSeparator

Separador decimal que se muestra en la tecla y en el display. Valor por defecto: ,.

Tipo: '.' | ','.

maxDecimals

Número máximo de decimales; sin límite si se omite.

Tipo: number.

keyboard

Entrada por teclado físico mientras este numpad es el último utilizado: dígitos, , / ., Retroceso, Supr o Escape para borrar, Enter para confirmar. true lo activa; un objeto define enabled (por defecto true) y submitOnEnter (por defecto true). Desactivado por defecto.

Tipo: boolean | ArcWidgetNumpadKeyboard.

Comportamiento y límites

  • onSubmit entrega un string con punto decimal, p. ej. "12.5", independientemente de decimalSeparator. Conviértelo con Number(value) y comprueba el resultado.
  • currentValue rellena el display. clearOnFirstInput es útil al sobrescribir un valor existente.
  • La entrada por teclado se ignora mientras un campo de texto u otro elemento editable tiene el foco.

Tipos de datos

Estos tipos relacionados con el widget se exportan desde el paquete. También están disponibles tipos comunes como ArcWidgetSlot, ArcWidgetStyles y ArcReactWidgetProps. Los objetos de configuración son cerrados, por lo que una clave mal escrita o no admitida se notifica como error de tipo.

export interface ArcWidgetNumpadDisplay {
	fontColor?: string;
	height?: string;
}

export interface ArcWidgetNumpadKeyboard { enabled?: boolean; submitOnEnter?: boolean; }

export interface ArcWidgetNumpadData { currentValue?: string | number; actionTitle?: string; backgroundColor?: string; fontColor?: string; display?: ArcWidgetNumpadDisplay; suffix?: string; clearOnFirstInput?: boolean; decimalSeparator?: '.' | ','; maxDecimals?: number; keyboard?: boolean | ArcWidgetNumpadKeyboard; }

export interface ArcWidgetNumpadProps extends ArcReactWidgetProps&lt;ArcWidgetNumpadData&gt; { onSubmit?: (value: string) =&gt; void; }</code></pre>