SearchView
Explicación del concepto de SearchView.
DEFINICIÓN
Un widget que facilita al usuario realizar búsquedas a una Proveedor de busqueda. Muestra un listado de sugerencias de resultado (si está disponible) y permite al usuario seleccionar un resultado para acceder a él.
Desde Android 3.0 utilizar un SearchView
desde la barra de la App es la forma preferida de admitir búsquedas en una App.
La información relativa a la implementación se encuentra en el segundo enlace al principio de la página "Como configurar una interfaz de búsqueda".
USO DESDE XML
Para que un SearchView
funcione de manera óptima, es importante que tenga espacio suficiente para mostrarse.
En este caso, vamos a utilizar una Activity con un SearchView y una ListView con los posibles resultados. Después configuraremos todo esto para darle vida.
Como vemos, la ListView no se ve, sin embargo es fundamental para el buen funcionamiento de la busqueda, tal y como la vamos a configurar en este ejemplo.
ATRIBUTOS
android:inconifiedByDefault
Define si lo que vemos por defecto es el icono de busqueda (true) o el campo de busqueda (false).
Es indispensable ponerlo en false para poder interactuar con el campo de busqueda.
android:imeOptions
Un editor de método de entrada (IME) es un control para el usuario que le permite ingresar texto.
Android proporciona un framework de método de entrada extensible que permite que las aplicaciones ofrezcan a los usuarios métodos de entrada alternativos, como teclados en pantalla o incluso entrada de voz.
Tiene las opciones en el siguiente enlace.
android:inputType
Explicado en Views -> Pallete Texts -> EditText.
android:maxWidth
Define la anchura máxima.
android:queryHint
Una ayuda opcional que muestra un texto de ejemplo en el cuadro de busquedas cuando se encuentra vacío.
CONFIGURACIÓN
La configuración de un SearchView
es bastante similar a la de un AutoCompleteTextView
:
Definir un adaptador
Vamos a utilizar un adaptador para la ListString que modifique su contenido en función de lo que capte el Listener del Search View:
Como en este ejemplo la lista va sobre Comunidades Autónomas en España, utilizamos un StringArray
que se ha almacenado previamente en el archivo strings.xml
.
Ahora ya tenemos el contenido contra el que se va a realizar la búsqueda.
Definir el listener
setOnQueryTextListener
Este listener, igual que el de las SeekBar tiene una forma curiosa pues recibe como argumento un objeto del tipo SearchView.OnQueryTextListener{}
que contiene los siguientes controladores:
OnQueryTextSubmit(query: String?): Boolean
Controla el momento en el que se envía una búsqueda dándole al botón de buscar.
OnQueryTextChange(query:String?): Boolean
Controla cada cambio que se realiza en la búsqueda.
Código
En el ejemplo que vamos a poner a continuación no se puede observar el buen funcionamiento de OnQueryTextSubmit(query: String?): Boolean
por que se ejecuta en todo momento lo programado en OnQueryTextChange(query:String?): Boolean
.
Para verlo correctamente es recomendable que implementen la prueba en su laboratorio y comenten el contenido de la última (exceptuando la linea de return).
Last updated