MaterialSearchView

介绍:

一个基于Material design 规范的Android 搜索控件。MaterialSearchView显示在Toolbar 或者 ActionBar 上面,并为用户显示一个最近搜索或者搜索提示的列表。

运行效果:

使用说明:

依赖

compile 'br.com.mauker.materialsearchview:materialsearchview:1.0.3'

最小sdk支持到14

首先添加到布局里面:

<br.com.mauker.materialsearchview.MaterialSearchView
    android:id="@+id/search_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

然后在activity中引用它:

// Activity:
MaterialSearchView searchView = (MaterialSearchView) findViewById(R.id.search_view);

要打开搜索视图,调用 searchView.openSearch()方法。

要关闭搜索视图,调用searchView.closeSearch()方法

可以用searchView.isOpen()方法来检查是否为打开状态

要使用back按钮来关闭搜索视图,在Activity中放入下面的代码:

@Override
public void onBackPressed() {
    if (searchView.isOpen()) {
        // Close the search on the back button press.
        searchView.closeSearch();
    } else {
        super.onBackPressed();
    }
}

搜索历史与搜索提示

你可以使用下面的方法提供搜索提示:

  • addSuggestions(String[] suggestions)

  • addSuggestions(ArrayList suggestions)

去掉搜索提示,可以使用:

  • clearSuggestions()

搜索历史由view自动处理,它是可以清除的:

  • clearHistory()

你也可以使用下面的方法来同时清除这两种数据:

  • clearAll()

接口

目前,有两个接口:

  • OnQueryTextListener: 这个接口处理MaterialSearchView中的QueryTextChange或者QueryTextSubmit事件。

  • SearchViewListener: 这个接口处理MaterialSearchView的打开和关闭事件。

已下载
0