NumericKeypad
El NumericKeypad reemplaza al teclado del celular en las pantallas donde el único dato a cargar es un número. Queda fijo al pie de la pantalla, se ve igual en iOS y Android, y no mueve el contenido al aparecer.
Previsualización Rápida
Section titled “Previsualización Rápida”Tocá las teclas para cargar un monto. Mantené presionada Borrar para vaciar el campo. Con el foco en el campo, el teclado físico también funciona.
Propósito
Section titled “Propósito”- Montos sin sorpresas: la coma decimal siempre está en el mismo lugar. Algunos teclados del sistema muestran punto en lugar de coma, según el idioma del equipo.
- Pantalla estable: el teclado del sistema achica la pantalla al abrirse y puede tapar el botón principal. El NumericKeypad forma parte del diseño, así que Continuar queda siempre a la vista.
- Misma experiencia en todos los equipos: mismo tamaño de teclas, mismo orden y misma respuesta al toque.
Anatomía del Componente
Section titled “Anatomía del Componente”- Grilla de 3 × 4: ocupa todo el ancho disponible, con una separación mínima entre teclas.
- Teclas numéricas: del 1 al 9 en tres filas y el 0 al centro de la última fila. Tienen fondo gris claro y un borde inferior que les da relieve, para que se reconozcan como teclas.
- Coma decimal: abajo a la izquierda, sin fondo y en un tono más suave, porque es una acción y no un número. Si el campo está vacío, escribe “0,”. No permite una segunda coma ni más decimales de los configurados.
- Borrar: abajo a la derecha, con el mismo tratamiento que la coma. Un toque borra el último carácter; mantener presionado borra todo.
- Anuncio para el lector de pantalla: una región invisible lee el valor después de cada cambio, por ejemplo “100.000”, o “Sin monto” si el campo queda vacío.
El teclado siempre se conecta a un campo real. El campo conserva el foco, el cursor y el teclado físico, pero el celular no abre su propio teclado.
Estados de Interacción
Section titled “Estados de Interacción”- Default: números con fondo gris claro y relieve inferior; coma y Borrar sin fondo.
- Hover: solo en equipos con mouse, la tecla se oscurece un tono.
- Presionado: la tecla se hunde: pierde el relieve, se achica levemente y toma el verde primario. Coma y Borrar se marcan en gris. En los celulares que lo permiten, suma una vibración corta.
- Focus: contorno azul visible cuando se recorre con teclado o lector de pantalla.
- Disabled: teclas en gris y sin respuesta. Usalo mientras se procesa una operación, nunca para ocultar el teclado.
Usos Recomendados y Guía de UX
Section titled “Usos Recomendados y Guía de UX”Cuándo usar
Section titled “Cuándo usar”- Montos: transferencias, pagos, recargas, extracciones y cualquier pantalla con un solo importe.
- Códigos numéricos cortos: token, códigos de verificación o PIN de tarjeta, usando la variante sin coma.
- Pantallas de un solo dato: el teclado queda siempre visible y el botón principal arriba de él.
Cuándo NO usar
Section titled “Cuándo NO usar”- Formularios con varios campos: si la pantalla mezcla texto y números, usá el teclado del sistema con un TextInput numérico. Dos teclados distintos en la misma pantalla confunden.
- Datos largos que se suelen pegar: CBU, CVU, CUIT o números de tarjeta. El teclado propio no permite pegar; usá un TextInput.
- Claves de acceso: las claves del usuario se cargan con el campo de contraseña del sistema, que convive con los gestores de contraseñas.
Variantes / Opciones
Section titled “Variantes / Opciones”Estilo (variant)
Section titled “Estilo (variant)”filled(por defecto): los números tienen fondo y relieve. Es la opción más clara para la mayoría de las pantallas, porque cada tecla se ve como un área para tocar.plain: todas las teclas sin fondo. Para pantallas con mucho contenido arriba del teclado, o cuando el teclado va sobre un fondo de color y el relleno gris no contrasta.
Con o sin coma decimal (decimal)
Section titled “Con o sin coma decimal (decimal)”- Con coma (por defecto): para montos. Acepta hasta 2 decimales, configurable con
maxDecimals. - Sin coma: para códigos y PIN. El lugar de la coma queda vacío para que el 0 y Borrar no cambien de posición.
Tamaño (size)
Section titled “Tamaño (size)”| Tamaño | Alto de tecla | Pauta de Diseño |
|---|---|---|
lg |
56px |
Estándar. Pantallas de monto y token. En pantallas de menos de 700 px de alto pasa solo a 48 px. |
md |
48px |
Cuando arriba del teclado hay más contenido, por ejemplo cuenta destino y selector de moneda. |
Otras opciones
Section titled “Otras opciones”- Largo máximo (
maxIntegers): cantidad de dígitos enteros que acepta. Por defecto, 10. - Vibración (
haptics): activa por defecto. Se puede apagar en flujos donde se tipea muy rápido, como un código. - Texto vacío (
emptyLabel): lo que anuncia el lector de pantalla cuando el campo queda vacío.