Skip to content

SearchField

El SearchField es el buscador de Monkey. Le permite al usuario encontrar rápidamente un dato dentro de un listado (un contacto, un movimiento, una cuenta) escribiendo una palabra o una frase, sin tener que recorrer toda la información.


8 contactos

  • Ana Gómez
  • ALF Shumway
  • Juan Pérez
  • Lucía Fernández
  • Martín Alfaro
  • Paula Rodríguez
  • Sofía Alfonsín
  • Tomás Ruiz

Escribí “alf”, “ALF” o “Alf”: vas a obtener los mismos resultados. Cuando dejás de escribir, la búsqueda se ejecuta sola y aparece el botón para borrarla.


El SearchField sirve para reducir un listado a lo que el usuario necesita ver. Su función dentro del flujo es acortar el camino hacia un dato conocido: el usuario sabe qué busca y el buscador se lo trae sin pasos intermedios. Como la búsqueda se dispara automáticamente al dejar de escribir, el usuario no necesita ningún botón adicional para ver resultados.


Text Error
  1. Icon (obligatorio): La lupa a la izquierda. Identifica el campo como buscador de un vistazo y no es interactivo.
  2. Label o valor: Muestra el placeholder (“Buscar”, “Buscar por contacto”) mientras el campo está vacío y el dato ingresado cuando el usuario escribe.
  3. ActionIcon (booleano): El botón X (CloseButton). Aparece cuando se ejecutó la búsqueda y permite borrarla.
  4. ErrorMessage (booleano): Mensaje en rojo con ícono de alerta que aparece debajo del campo cuando hay un error.
  5. Background (obligatorio): El fondo gris claro de la caja. Se mantiene igual en todos los estados.
  6. Stroke (obligatorio): El borde de la caja, con forma de píldora (bordes completamente redondeados). Cambia de color y grosor según el estado (default, hover, active, error, disabled).

El placeholder y el valor ingresado se comportan distinto cuando el texto no entra en la caja.

  • Default: solo se trunca el placeholder, con puntos suspensivos al final.
  • Typing: el valor ingresado no se trunca ni pasa a un segundo renglón.
  • Entered: el texto continúa en una sola línea y siempre muestra lo último que ingresó el usuario, que es la parte que necesita confirmar.

La búsqueda no distingue mayúsculas de minúsculas (case-insensitive). “ALF”, “Alf” y “alf” devuelven exactamente los mismos resultados, así el usuario no tiene que preocuparse por cómo escribe el dato. Los espacios al inicio y al final también se ignoran.

Cuando el usuario deja de escribir, el componente espera un instante (por defecto, medio segundo) y recién ahí trae los posibles resultados desde la base de datos. Así se evita llamar al servicio con cada letra y la lista no “salta” mientras el usuario todavía está escribiendo. Si el usuario presiona Enter, la búsqueda se ejecuta en el momento.


Se usa cuando la búsqueda se realiza sobre un solo campo de la base de datos.

  • Usá el SearchField tal como está documentado en esta página.
  • El placeholder debe indicar cuál es el campo a buscar: “Buscar por contacto”.
  • El usuario escribe una palabra o una frase y el filtrado se hace cuando se dispara la búsqueda.

Se usa cuando la búsqueda se realiza sobre varios campos de la base de datos.

  • El placeholder es simplemente “Buscar”.
  • Cuando el usuario hace clic en el buscador, pasa al estado Active y se despliega automáticamente el componente Menu.SearchField con todos los campos posibles para buscar.
  • El UX debe definir el Regex (la regla que valida qué formato acepta cada campo).
  • Consultá la documentación del componente Menu.SearchField antes de diseñar este caso.

  • Cada funcionalidad debe definir cuántos y cuáles serán los datos del servicio a filtrar.
  • El buscador admite valores numéricos, alfabéticos o alfanuméricos.
  • Permite buscar un solo valor por vez. No admite entrada múltiple de datos: si el usuario necesita combinar criterios, usá filtros complementarios.

Al ejecutar la búsqueda aparece el botón X. Al presionarlo, borra el valor y vuelve a llamar al servicio sin ese filtro, de modo que el listado vuelve a mostrarse completo. El foco regresa al campo para que el usuario pueda escribir una nueva búsqueda.

  • Mobile: el buscador ocupa el 100% del ancho disponible (respetando los márgenes de la pantalla).
  • Desktop: no debe ocupar más de 6 columnas de la grilla.

Este campo es obligatorio.
Text Error
  • Default: Estado inicial del componente, sin datos ingresados. Se ve la lupa, el placeholder y el stroke gris.
  • Hover: Al pasar el cursor, el stroke se oscurece levemente para confirmar que el campo es interactivo.
  • Active: El usuario hace clic dentro del input para empezar a completarlo. El stroke toma el color primario y se vuelve más grueso; el cursor aparece delante del placeholder, que se mantiene visible.
  • Typing: El usuario está escribiendo. Se mantiene la apariencia de Active con el valor y el cursor visibles.
  • Entered: El usuario ya escribió y la búsqueda se ejecutó. El stroke vuelve a gris y aparece el CloseButton.
  • Error campo vacío: El usuario no completó un campo obligatorio. El stroke y la lupa pasan a rojo y se muestra “Este campo es obligatorio.”.
  • Error dato erróneo: El usuario ingresó un dato incorrecto (por ejemplo, letras en un campo que solo admite números). El stroke, la lupa y el valor ingresado pasan a rojo, y el mensaje explica qué está mal.
  • Disabled Default: El componente está vacío y deshabilitado. Se usa, por ejemplo, mientras el listado todavía no está disponible.
  • Disabled Filled: El componente tiene datos cargados pero no se puede editar. El stroke, la lupa y el texto se atenúan.

  • Para encontrar un elemento dentro de un listado extenso: contactos, movimientos, cuentas, comprobantes.
  • Cuando el usuario ya sabe qué está buscando y puede escribirlo (un nombre, un número, un alias).
  • Arriba del listado que filtra, para que la relación entre el buscador y los resultados sea evidente.
  • Listados cortos que entran completos en pantalla: el buscador agrega un paso que no ahorra nada.
  • Filtrar por categorías o rangos (fechas, tipos, estados): usá filtros, chips o un Select. El buscador es para texto libre.
  • Combinar varios criterios a la vez: el SearchField admite un solo valor. Resolvelo con filtros complementarios.
  • Ingresar datos de un formulario: si el dato se guarda en lugar de usarse para encontrar algo, usá un TextInput.

Las variantes de estado están documentadas en Estados de Interacción: Default, Active, Typing, Entered, Disabled Filled, Disabled Default, Error campo vacío y Error dato erróneo.

  • Default: es el tamaño que se usa en ambos devices (mobile y desktop). Tiene una altura de 48 px, cómoda para el uso táctil.

Variante para la búsqueda en varias columnas. Al activar el buscador se despliega el menú con los campos disponibles para buscar.


Semántica

  • El campo se anuncia como cuadro de búsqueda y siempre tiene un label, aunque sea visualmente oculto.

Orden de foco

  • Input → CloseButton (si está visible).

Lector de pantalla

  • El CloseButton se anuncia como “Borrar búsqueda”.
  • Al buscar, la cantidad de resultados se anuncia automáticamente sin interrumpir al usuario (“12 resultados”).
  • El valor se lee como “Buscador” seguido del valor ingresado.
  • La lupa es decorativa: se oculta al lector de pantalla para no agregar ruido.

Navegación por teclado

  • El usuario navega con Tab y ejecuta con Enter o Space.
  • Enter dentro del campo ejecuta la búsqueda sin esperar el delay.
  • Si el CloseButton está visible, debe poder tomar foco.

Semántica

  • El contenedor se identifica con el rol de búsqueda.

Orden de foco

  • Igual que en Web.

Lector de pantalla

  • La cantidad de resultados se anuncia automáticamente sin interrumpir al usuario.

Navegación por teclado

  • No aplica.

Consultá el historial de cambios de todos los componentes de este Design System en la Sheet de ChangeLog.