Сегодня мы рассмотрим виджет Android SearchView и разработаем приложение, которое фильтрует ListView по введенному тексту. Мы будем использовать DataBinding для связывания макетов в активностях и адаптерах. Если вы еще не читали о DataBinding, сначала ознакомьтесь с этим учебником для лучшего понимания.
Android SearchView
Android позволяет нам использовать функцию поиска в нашем приложении, отображая виджет SearchView либо в ToolBar/ActionBar, либо вставляя его в макет. Виджет SearchView доступен начиная с Android 3.0. SearchView определяется в макете XML, как показано ниже.
<android.support.v7.widget.SearchView
android:id="@+id/search"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
В Android существует множество форм поиска, таких как голосовой поиск, подсказки и т. д. В этом уроке мы будем использовать интерфейсы SearchView.OnQueryTextListener
и Filterable
. Интерфейс Filterable фильтрует введенный текст по ListView и отображает результаты. Интерфейс OnQueryTextListener
может определить два события.
onQueryTextChange
вызывается, когда пользователь вводит каждый символ в поле ввода текста.onQueryTextSubmit
вызывается при нажатии кнопки поиска
Пример поиска в Android SearchView
На изображении ниже показан конечный проект примера поиска в Android SearchView. Проект состоит из активности и адаптера для ListView.
Код примера поиска в Android SearchView
Файл activity_main.xml приведен ниже. Он состоит из ListView с SearchView сверху. activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="https://schemas.android.com/apk/res/android">
<RelativeLayout
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:orientation="horizontal">
<android.support.v7.widget.SearchView
android:id="@+id/search"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:clickable="true" />
<ListView
android:id="@+id/list_view"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_alignParentLeft="true"
android:layout_alignParentStart="true"
android:layout_below="@+id/search" />
</RelativeLayout>
</layout>
Файл MainActivity.java приведен ниже.
package com.journaldev.searchview;
import android.databinding.DataBindingUtil;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.support.v7.widget.SearchView;
import com.journaldev.searchview.databinding.ActivityMainBinding;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends AppCompatActivity {
ActivityMainBinding activityMainBinding;
ListAdapter adapter;
List<String> arrayList= new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
activityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
arrayList.add("January");
arrayList.add("February");
arrayList.add("March");
arrayList.add("April");
arrayList.add("May");
arrayList.add("June");
arrayList.add("July");
arrayList.add("August");
arrayList.add("September");
arrayList.add("October");
arrayList.add("November");
arrayList.add("December");
adapter= new ListAdapter(arrayList);
activityMainBinding.listView.setAdapter(adapter);
activityMainBinding.search.setActivated(true);
activityMainBinding.search.setQueryHint("Type your keyword here");
activityMainBinding.search.onActionViewExpanded();
activityMainBinding.search.setIconified(false);
activityMainBinding.search.clearFocus();
activityMainBinding.search.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
@Override
public boolean onQueryTextSubmit(String query) {
return false;
}
@Override
public boolean onQueryTextChange(String newText) {
adapter.getFilter().filter(newText);
return false;
}
});
}
}
В вышеприведенном коде мы передаем ArrayList месяцев в адаптер списка. Мы вызываем метод фильтра, определенный в классе адаптера, каждый раз, когда изменяется текст поискового запроса. Класс ListAdapter.java выглядит следующим образом.
package com.journaldev.searchview;
import android.content.Context;
import android.databinding.DataBindingUtil;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.Filter;
import android.widget.Filterable;
import com.journaldev.searchview.databinding.RowItemBinding;
import java.util.ArrayList;
import java.util.List;
public class ListAdapter extends BaseAdapter implements Filterable {
List<String> mData;
List<String> mStringFilterList;
ValueFilter valueFilter;
private LayoutInflater inflater;
public ListAdapter(List<String> cancel_type) {
mData=cancel_type;
mStringFilterList = cancel_type;
}
@Override
public int getCount() {
return mData.size();
}
@Override
public String getItem(int position) {
return mData.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, final ViewGroup parent) {
if (inflater == null) {
inflater = (LayoutInflater) parent.getContext()
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
}
RowItemBinding rowItemBinding = DataBindingUtil.inflate(inflater, R.layout.row_item, parent, false);
rowItemBinding.stringName.setText(mData.get(position));
return rowItemBinding.getRoot();
}
@Override
public Filter getFilter() {
if (valueFilter == null) {
valueFilter = new ValueFilter();
}
return valueFilter;
}
private class ValueFilter extends Filter {
@Override
protected FilterResults performFiltering(CharSequence constraint) {
FilterResults results = new FilterResults();
if (constraint != null && constraint.length() > 0) {
List<String> filterList = new ArrayList<>();
for (int i = 0; i < mStringFilterList.size(); i++) {
if ((mStringFilterList.get(i).toUpperCase()).contains(constraint.toString().toUpperCase())) {
filterList.add(mStringFilterList.get(i));
}
}
results.count = filterList.size();
results.values = filterList;
} else {
results.count = mStringFilterList.size();
results.values = mStringFilterList;
}
return results;
}
@Override
protected void publishResults(CharSequence constraint,
FilterResults results) {
mData = (List<String>) results.values;
notifyDataSetChanged();
}
}
}
Как видно в вышеприведенном коде, мы выполняем фильтрацию с использованием внутреннего класса ValueFilter
, который расширяет класс Filter. Он фильтрует список, проверяя, совпадает ли текст поискового запроса с строками, заданными в ArrayList. XML-макет для строки ListView приведен ниже. row_item.xml
<layout xmlns:android="https://schemas.android.com/apk/res/android">
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView
android:id="@+id/stringName"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentLeft="true"
android:layout_alignParentStart="true"
android:layout_centerVertical="true"
android:padding="@dimen/activity_horizontal_margin"
android:textAllCaps="false"
android:textAppearance="?android:attr/textAppearanceMedium" />
</RelativeLayout>
</layout>
Вот результат работы приложения поиска Android SearchView. Показанный выше SearchView требует, чтобы мы нажимали на значок поиска, чтобы активировать текстовое поле. Кроме того, в нем нет текста подсказки/замещающего текста. Добавьте следующий код в MainActivity, чтобы включить SearchView по умолчанию и отобразить подсказку.
activityMainBinding.search.setActivated(true);
activityMainBinding.search.setQueryHint("Type your keyword here");
activityMainBinding.search.onActionViewExpanded();
activityMainBinding.search.setIconified(false);
activityMainBinding.search.clearFocus();
SearchView после настройки выглядит так. Этим завершается учебник по использованию SearchView в Android. Мы подробно рассмотрим продвинутые функции SearchView в следующем уроке. Вы можете скачать Проект Android SearchView по ссылке ниже.
Source:
https://www.digitalocean.com/community/tutorials/android-searchview-example-tutorial