Android修行手册 - 官方SearchView使用/属性/监听

👉关于作者

众所周知，人生是一个漫长的流程，不断克服困难，不断反思前进的过程。在这个过程中会产生很多对于人生的质疑和思考，于是我决定将自己的思考，经验和故事全部分享出来，以此寻找共鸣！！！

专注于Android/Unity和各种游戏开发技巧，以及各种资源分享（网站、工具、素材、源码、游戏等）

欢迎关注公众号【空名先生】获取更多资源和交流！

👉前提

这是小空坚持写的Android新手向系列，欢迎品尝。

新手（√√√）

大佬（√）

👉实践过程

搜索框是每个应用必备的功能，她提供了一个用户界面，用于用户可以快速检索出目标内容，除了自定义View实现之外，Android官方老早就内置了SearchView控件，而且能满足不少应用场景。

😜基本使用

布局

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
 
    <androidx.appcompat.widget.SearchView
        android:id="@+id/activitySearchView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</RelativeLayout>

点击事件

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_search_view)
    activitySearchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
        override fun onQueryTextSubmit(query: String?): Boolean {
            Toast.makeText(this@SearchViewActivity, "点击搜索按钮时触发", Toast.LENGTH_SHORT).show()
            return false
        }
 
        override fun onQueryTextChange(newText: String?): Boolean {
            Toast.makeText(this@SearchViewActivity, "搜索内容改变时触发", Toast.LENGTH_SHORT).show()
            return false
        }
    })
}

搜索按钮是软键盘上的按钮，事件中返回true，点击搜索按钮后软键盘不自动消失，返回false，表示点击搜索按钮后软键盘自动消失。

运行后你会发现，刚展示的只有一个搜索ICON，点击后才会扩大出搜索框，事实上很多主流App都是这么干的，既增加了屏幕布局的可用面积，也增加了动画效果看起来更舒服。

😜属性

android:imeOptions=“actionSearch”：meOptions属性是EditText特有的属性，通过源码可知SearchView中显示的编辑框其实就是EditText的子类，imeOptions的其他动作可看小空关于EditText文章教程，超详细。

app:iconifiedByDefault=“false”：设置默认是否展开搜索框，上面截图可看出未展开前只有个搜索ICON，展开后会增加输入框和叉号。该属性默认是true，表示不展开，false表示展开。

app:queryHint=“提示文本”：设置提示文本，和EditText的hint一样

app:searchIcon="@drawable/icon_xin"：修改搜索ICON图标

app:closeIcon="@drawable/icon_xinsui"：修改关闭叉叉按钮ICON图标

app:queryBackground="@null"：去除下划线以及设置背景

onActionViewCollapsed()：代码控制将搜索框设置为未展开

onActionViewExpanded()：代码设置搜索框展开

onActionViewExpanded()：设置关闭图标不显示

😜事件监听

setOnQueryTextListener(OnQueryTextListener listener) 实现文本改变时的监听和搜索提交时的监听

setOnSearchClickListener(OnClickListener listener) 在点击Search那个图标的时候回调的方法。

setOnCloseListener(OnCloseListener listener)  在点击搜索后那个叉号的时候回调的方法。

📢作者：小空和小芝中的小空

📢转载说明-务必注明来源：芝麻粒儿 的个人主页 - 专栏 - 掘金 (juejin.cn)

📢这位道友请留步☁️，我观你气度不凡，谈吐间隐隐有王者霸气💚，日后定有一番大作为📝！！！旁边有点赞👍收藏🌟今日传你，点了吧，未来你成功☀️，我分文不取，若不成功⚡️，也好回来找我。