• Stars
    star
    422
  • Rank 102,753 (Top 3 %)
  • Language
    Java
  • Created over 7 years ago
  • Updated almost 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🔍一个自定义搜索框

License

CardSearchView

本项目是受BilibiliSearchView的启发,因此想对其进行完善,打包成库,方便自己以后的使用,也方便大家的快速导入。 在此,感谢原作者

预览

版本更新说明

版本更新说明

获取

先在 build.gradle 的 repositories 添加:

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

再在dependencies添加:

dependencies {
	implementation 'com.github.limuyang2:CardSearchView:1.1.0.1'
}

使用

在根布局中添加以下代码:

xmlns:app="http://schemas.android.com/apk/res-auto"

在布局中使用:

  <km.lmy.searchview.SearchView
        android:id="@+id/searchView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="4dp"
        app:cardBackgroundColor="#fff"
        app:cardCornerRadius="5dp"
        app:cardElevation="4dp"
        app:defaultState="open"
        app:hintText="input name" />

提示

SearchView继承于系统控件CardView,所以可直接使用CardView的属性,例如:
设置背景色(app:cardBackgroundColor)、圆角(app:cardCornerRadius)等等

xml设置属性说明

xml属性 类型 说明
app:hintText String 输入框提示文本
app:backIcon Drawable 返回按钮图标
app:oneKeyCleanIcon Drawable 一键清除图标
app:historyIcon Drawable 历史纪录左侧图标
app:defaultState enum 控件初始状态是否处于打开状态(默认“close”),值:“open”、“close”
app:historyTextColor Color Int 历史纪录文字颜色
app:inputView_height Int(dp) 搜索输入框的高度

Java方法设置属性说明

属性方法 传入数据类型 说明
setHintText String 输入框提示文本
setBackIcon int 返回按钮图标
setOneKeyCleanIcon int 一键清除图标
setHistoryIcon int 历史纪录左侧图标
defaultState int 控件初始状态是否处于打开状态(默认关闭) SearchView.CLOSE:关闭;SearchView.OPEN:打开
setHistoryTextColor int 历史纪录文字颜色
open 打开SearchView
close 关闭SearchView
autoOpenOrClose 自动打开关闭SearchView
isOpen 搜索框是否打开
setOneKeyCleanIsVisible boolean 设置一键清除按钮是否显示(true:显示;false:不现实(默认为true))
setSearchEditText String 设置搜索框初始文本
setSearchEditTextEnabled boolean 设置输入框处于是否可编辑状态
getEditTextView 获取搜索输入框控件
setSearchInputViewHeight int 设置搜索输入框的高度

Java方法使用说明

使用方法 传入数据类型 说明
addOneHistory String 添加一条历史纪录
addHistoryList List 添加历史纪录列表
setNewHistoryList List 设置全新的历史记录列表
setHistoryItemClickListener OnHistoryItemClickListener 设置历史纪录点击事件
setOnSearchActionListener OnSearchActionListener 设置软键盘搜索按钮点击事件
setOnInputTextChangeListener OnInputTextChangeListener 设置输入文本监听事件
setOnSearchBackIconClickListener OnSearchBackIconClickListener 自定义返回按钮点击监听事件(默认为关闭搜索框)
setOnCleanHistoryClickListener OnCleanHistoryClickListener 设置"清除历史"点击监听

示例参考

MainActivity.java

与AppBarLayout、ToolBar一起使用不显示?

原因

如下布局所示,当在Toolbar外嵌套AppBarLayout后,会有好看的阴影效果,这是在Android5.0后新加入的Material Design效果,强调布局的层级性。由于AppBarLayout会提高布局的Z轴坐标,产生层级,因此,在ToolBar上的其他控件会因为层级低于AppBarLayout而导致被遮盖。

<android.support.design.widget.AppBarLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:fitsSystemWindows="true">

    <android.support.v7.widget.Toolbar
        android:id="@+id/activity_toolbar"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:titleTextColor="@android:color/white">

    </android.support.v7.widget.Toolbar>

</android.support.design.widget.AppBarLayout>

解决办法如下

只需要将SearchView的层级提高到和AppBarLayout一样即可。在SearchView的XML中加入下面一句话即可。

app:cardElevation="4dp"

示例

<android.support.design.widget.AppBarLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:fitsSystemWindows="true">

    <android.support.v7.widget.Toolbar
        android:id="@+id/activity_toolbar"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:titleTextColor="@android:color/white">

    </android.support.v7.widget.Toolbar>

</android.support.design.widget.AppBarLayout>

<km.lmy.searchview.SearchView
     app:cardElevation="4dp"
     android:id="@+id/searchView"
     android:layout_width="match_parent"
         android:layout_height="wrap_content"/>

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.