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

1,821 阅读3分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第24天,点击查看活动详情

👉关于作者

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

专注于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都是这么干的,既增加了屏幕布局的可用面积,也增加了动画效果看起来更舒服。

image.png

😜属性

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)

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