加入CODE CHINA

· 不限速    · 不限空间    · 不限人数    · 私仓免费

免费加入
    README.md

    SearchLayout

    • 作者:Carson_Ho
    • 概述

    示意图

    注:关于该开源项目的意见 & 建议可在Issue上提出。欢迎 Star !

    1. 简介

    一款封装了 历史搜索记录功能 & 样式Android自定义搜索框

    已在Github开源:地址:SearchLayout,欢迎 Star

    示意图

    2. 功能介绍

    2.1 需求场景

    示意图

    2.2 功能需求

    • 功能列表

    示意图

    • 功能原型

    示意图

    2.3 功能示意

    示意图

    3. 特点

    3.1 功能实用

    • 该搜索框开源库具备除了历史搜索记录功能外,还具备一般的搜索框功能(如一键清空搜索框内容等等)
    • 封装了 常见的搜索框样式(如左侧图标、返回按键等等),使用起来更加方便

    3.2 使用简单

    仅需要简单的xml属性配置

    下面1节会详细介绍其使用方法

    3.3 二次开发成本低

    所以,在其上做二次开发 & 定制化成本非常低。

    4. 具体使用

    该款SearchLayout使用非常简单,仅需2步:

    步骤1:导入控件库

    主要有 Gradle & Maven 2种方式:

    • 方式1:Gradle引入依赖 build.Gradle
    dependencies {
        compile 'com.carson_ho:SearchLayout:1.0.1'
    }
    • 方式2:Maven引入依赖 pom.xml
    <dependency>
      <groupId>com.carson_ho</groupId>
      <artifactId>SearchLayout</artifactId>
      <version>1.0.1</version>
      <type>pom</type>
    </dependency>

    步骤2:设置搜索框样式

    • 具体属性设置

    示意图

    • 使用示例 在XML文件中进行设置 activity_main.xml
    <scut.carson_ho.searchview.SearchView
            android:id="@+id/search_view"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:textSizeSearch="5dp"
            app:textColorSearch="#3F51B5"
            app:textHintSearch="输入查询关键字"
            app:searchBlockHeight="150"
            app:searchBlockColor="#ffffff"
            />

    步骤3:设置点击键盘上的搜索按键 & 返回按键后的操作

    MainActivity.java

    // 1. 初始化搜索框变量
        private SearchView searchView;
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            
            // 2. 绑定视图
            setContentView(R.layout.activity_search);
    
            // 3. 绑定组件
            searchView = (SearchView) findViewById(R.id.search_view);
    
            // 4. 设置点击键盘上的搜索按键后的操作(通过回调接口)
            // 参数 = 搜索框输入的内容
            searchView.setOnClickSearch(new ICallBack() {
                @Override
                public void SearchAciton(String string) {
                    System.out.println("我收到了" + string);
                }
            });
            
            // 5. 设置点击返回按键后的操作(通过回调接口)
            searchView.setOnClickBack(new bCallBack() {
                @Override
                public void BackAciton() {
                    finish();
                }
            });
        }
    }

    5. 完整Demo地址

    Carson_Ho的Github地址:SearchLayout

    示意图

    6. 源码解析

    请看文章Android开源库:手把手教你实现一个简单好用的搜索框(含历史搜索记录)

    7. 开源协议

    SearchLayout 遵循 MIT 开源协议

    8. 贡献代码

    • 具体请看:贡献代码说明
    • 关于该开源项目的意见 & 建议可在Issue上提出。欢迎 Star !

    9. 版本说明

    2017-08-11 v1.0.0 :基础功能上线(关键字搜索、历史搜索记录 & 一键删除功能)

    关于作者

    项目简介

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/carson-ho/search_layout

    发行版本

    当前项目没有发行版本

    贡献者 1

    开发语言

    • Java 100.0 %