# Search_Layout

**Repository Path**: neuliying/Search_Layout

## Basic Information

- **Project Name**: Search_Layout
- **Description**: 一款封装了 历史搜索记录功能 & 样式 的Android自定义搜索框（改良版）
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-11-11
- **Last Updated**: 2022-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SearchLayout

[![Download](https://api.bintray.com/packages/liying2008/SearchView/search-view/images/download.svg) ](https://bintray.com/liying2008/SearchView/search-view/_latestVersion)

>[中文文档](README.md)
- Original Author：Carson_Ho
- Modifier: LiYing

## 1. Introduction
A simple & useful  Android DIY View  for Searching function
>[LiYing's Github：SearchLayout](https://github.com/liying2008/Search_Layout)，welcome  Star ！

![Demo](screenshots/search_view_demo.gif)

## 2. Application Scenarios
Searching  & High Diy style

## 3. Feature
- Fresh & concise style
- Easy to use
- Secondary Programming costs are low

## 4. Usage

##### Step 1：Import Library

There are two ways to  import Library：

- For Gradle

*build.gradle*

```gradle
dependencies {
    implementation 'cc.duduhuo:search-view:1.1.6'
}
```

- For Maven

*pom.xml*

```xml
<dependency>
  <groupId>cc.duduhuo</groupId>
  <artifactId>search-view</artifactId>
  <version>1.1.6</version>
  <type>pom</type>
</dependency>
```


##### Step 2：Set Animation Attributes

- Attributes Description：

|             属性             |     描述     |    类型     |                 默认值                 |
| :------------------------: | :--------: | :-------: | :---------------------------------: |
|       searchTextSize       |   搜索字体大小   | dimension |                14sp                 |
|      searchTextColor       |   搜索字体颜色   |   color   |               #9B9B9B               |
|       searchTextHint       | 搜索框编辑框提示内容 |  string   |               输入查询关键字               |
|    searchTextBackground    |  搜索编辑框背景   | reference |                  0                  |
|      searchBlockColor      |  搜索控件背景颜色  |   color   |               #FFFFFF               |
|   searchBlockBackground    |   搜索控件背景   | reference |                  -                  |
|     searchBlockHeight      |   搜索控件高度   | dimension |                46dp                 |
|   searchButtonBackground   |   搜索按钮背景   | reference |                  0                  |
|   searchButtonIconColor    |  搜索按钮图标颜色  |   color   |               #878787               |
|    searchButtonVisible     |  搜索按钮是否可见  |  boolean  |                true                 |
|         iconColor          |  所有图标的颜色   |   color   |               #878787               |
|       backIconColor        |  返回图标的颜色   |   color   |               #878787               |
|      searchIconColor       |  搜索图标的颜色   |   color   |               #878787               |
|      deleteIconColor       |  删除图标的颜色   |   color   |               #878787               |
|     searchIconVisible      |  搜索图标是否可见  |  boolean  |                false                |
|      clearHistoryText      |  清除历史记录文字  |  string   |               清空搜索历史                |
|   clearHistoryTextColor    | 清除历史记录文字颜色 |   color   |               #606060               |
|    clearHistoryTextSize    | 清除历史记录文字大小 | dimension |                14sp                 |
| clearHistoryTextBackground | 清除历史记录文字背景 | reference | pressed: #ececec<br>normal: #e2e2e2 |


- Use examples

In layout xml file.

```xml
<scut.carson_ho.searchview.SearchView
    android:id="@+id/search_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:clearHistoryText="清空搜索历史"/>
```


### Step 3：Setting actions when clicking search & back button

```java
private SearchView searchView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_search);
    // 搜索框组件
    searchView = findViewById(R.id.search_view);
    // 是否在点击历史条目后启动搜索
    searchView.startSearchWhenHistoryItemClick = true;
    // 设置点击搜索按键后的操作（通过回调接口）
    // 参数 = 搜索框输入的内容
    searchView.setOnSearchListener(new OnSearchListener() {
        @Override
        public void onSearch(String keyword) {
            Toast.makeText(SearchViewDemoActivity.this, "搜索关键词：" + keyword, Toast.LENGTH_SHORT).show();
            // 也可通过 getSearchText() 方法获取搜索框中的内容
            String searchText = searchView.getSearchText();
            System.out.println(searchText);
            // 如果需要自定义搜索按钮，可以在按钮的click事件中调用 startSearch() 方法。
            // searchView.startSearch();
        }
    });
    // 设置点击返回按键后的操作（通过回调接口）
    searchView.setOnBackListener(new OnBackListener() {
        @Override
        public void onBack() {
            finish();
        }
    });
}
```

## 5. Complete Demo

[LiYing's Github：SearchLayout](https://github.com/liying2008/Search_Layout)


## 6.  LICENSE

[MIT](LICENSE)

## 7. Contribute

Before you open an issue or create a pull request, please read [Contributing Guide](CONTRIBUTING.md) first.

## 8. Release

[CHANGELOG](CHANGELOG.md)



# About Original Author
- ID：Carson_Ho
- 简介：CSDN签约作者、简书推荐作者、稀土掘金专栏作者
- E - mail：[carson.ho@foxmail.com](mailto:carson.ho@foxmail.com)
- Github：[https://github.com/Carson-Ho](https://github.com/Carson-Ho)
- CSDN：[http://blog.csdn.net/carson_ho](http://blog.csdn.net/carson_ho)
- 简书：[http://www.jianshu.com/u/383970bef0a0](http://www.jianshu.com/u/383970bef0a0)
- 稀土掘金：[https://juejin.im/user/58d4d9781b69e6006ba65edc](https://juejin.im/user/58d4d9781b69e6006ba65edc)


# About Modifier
- ID：liying2008
- E - mail：[liruoer2008@yeah.net](mailto:liruoer2008@yeah.net)
- Github：[https://github.com/liying2008](https://github.com/liying2008)
- CSDN：[https://blog.csdn.net/u012939909](https://blog.csdn.net/u012939909)
- 简书：[https://www.jianshu.com/u/14ab91761183](https://www.jianshu.com/u/14ab91761183)