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
onSubmitentrega un string con punto decimal, p. ej."12.5", independientemente dedecimalSeparator. Conviértelo conNumber(value)y comprueba el resultado.
currentValuerellena el display.clearOnFirstInputes ú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<ArcWidgetNumpadData> { onSubmit?: (value: string) => void; }</code></pre>