使用DataBinding的Android SearchView示例教程
今天我们将探讨Android的SearchView小部件,并开发一个通过查询文本对ListView进行筛选的应用程序。我们将使用DataBinding来连接Activity和Adapter中的布局。如果您还没有阅读有关DataBinding的文档,请先参考此教程以更好地理解。
安卓搜索视图
Android允许我们通过在工具栏/操作栏中显示SearchView小部件或将其插入布局来使用应用程序中的搜索功能。Android 3.0版本开始提供Android SearchView小部件。如下所示,可以在XML布局中定义SearchView。
<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上过滤查询的文本,并显示结果的ListView行。OnQueryTextListener接口可以检测到两个事件。
-
- 当用户在文本字段中输入每个字符时,将调用onQueryTextChange函数。
- 当用户按下搜索按钮时,将触发onQueryTextSubmit函数。
Android搜索视图示例
下图展示了最终的Android SearchView示例项目。该项目包含一个活动(Activity)和一个用于ListView的适配器(Adapter)。
Android搜索视图示例代码
安卓搜索视图示例代码
以下是activity_main.xml文件。它包含一个ListView并在顶部有一个SearchView。
<?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.Olivia.searchview;
import android.databinding.DataBindingUtil;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.support.v7.widget.SearchView;
import com.Olivia.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;
}
});
}
}
在上述代码中,我们将一个月份数组列表传递给列表适配器。每次搜索查询文本发生变化时,我们都会调用在适配器类中定义的筛选方法。ListAdapter.java 类的代码如下。
package com.Olivia.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.Olivia.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中给定的字符串匹配来对列表进行过滤。ListView行的XML布局如下所示: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要求我们点击搜索图标以激活文本字段。此外,它不包含任何提示/占位文本。在MainActivity中添加以下代码可以默认启用SearchView并显示一个提示。
activityMainBinding.search.setActivated(true);
activityMainBinding.search.setQueryHint("Type your keyword here");
activityMainBinding.search.onActionViewExpanded();
activityMainBinding.search.setIconified(false);
activityMainBinding.search.clearFocus();
经过以上的定制,搜索视图(SearchView)看起来是这样的。这结束了Android搜索视图教程。在以后的教程中,我们将深入研究搜索视图的高级功能。您可以通过下面提供的链接下载Android搜索视图项目。
下载Android SearchView 示例项目