Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/renaudcerrato/FloatingSearchView
Yet another floating search view implementation, also known as persistent search.
https://github.com/renaudcerrato/FloatingSearchView
Last synced: 2 months ago
JSON representation
Yet another floating search view implementation, also known as persistent search.
- Host: GitHub
- URL: https://github.com/renaudcerrato/FloatingSearchView
- Owner: renaudcerrato
- License: apache-2.0
- Created: 2015-12-30T20:18:59.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-10-20T11:21:51.000Z (about 2 years ago)
- Last Synced: 2024-08-02T01:22:38.103Z (6 months ago)
- Language: Java
- Homepage:
- Size: 10.3 MB
- Stars: 1,332
- Watchers: 26
- Forks: 161
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - FloatingSearchView - 浮动的搜索视图实现 (SearchView)
README
# FloatingSearchView [](http://androidweekly.net/issues/issue-186) [](https://jitpack.io/#renaudcerrato/FloatingSearchView)
Yet another floating search view implementation, also known as persistent search: that implementation fully supports menu (including submenu), logo and animated icon. Dropdown suggestions are backed by a `RecyclerView` and you can provide your own `RecyclerView.Adapter`, `ItemDecorator` or `ItemAnimator`. No hiding.
[DEMO APK](https://github.com/renaudcerrato/FloatingSearchView/raw/master/sample/sample-debug.apk)
# Usage
Add a [`FloatingSearchView`](https://github.com/renaudcerrato/FloatingSearchView/blob/master/library/src/main/java/com/mypopsy/widget/FloatingSearchView.java) to your view hierarchy, make sure that it takes up the full width and height:
```xml
```
See the [supported attributes](https://github.com/renaudcerrato/FloatingSearchView/blob/master/library/src/main/res/values/attrs.xml).
Then, configure your instance and set your listeners to react accordingly:
```java
mSuggestionsAdapter = new MySuggestionsAdapter(); // use a RecyclerView.Adapter
mSearchView.setAdapter(mSuggestionsAdapter);
...
mSearchView.setOnIconClickListener(...);
mSearchView.setOnSearchListener(...);
mSearchView.addTextChangedListener(...);
mSearchView.setOnSearchFocusChangedListener(...);
```
Look at the [sample](https://github.com/renaudcerrato/FloatingSearchView/blob/master/sample/src/main/java/com/mypopsy/floatingsearchview/MainActivity.java).
## Menu
The implementation fully supports menu (and submenu):
```xml
```
```java
mSearchView.setOnMenuItemClickListener(...);
```
Menu items can be automatically hidden when the search view gets focus depending on the value of the MenuItem's `showAsAction`:
```xml
// always shown
// will hide on focus
// will go into the overflow menu
```
## Animated Icon
`FloatingSearchView` will automagically animate icons drawable, given they declare a `progress` property:
* `void setProgress(float)`
* `float getProgress()`
> example: [`DrawerArrowDrawable`](https://developer.android.com/reference/android/support/v7/graphics/drawable/DrawerArrowDrawable.html) or [ToggleDrawable](https://github.com/renaudcerrato/ToggleDrawable)
## Other
Since the implementation tries to focus on core logic instead of business logic as much as possible, common features like *"tap to clear"*, *"speech to text"* or *"loading progress"* are voluntarily **NOT** built-in because they can be easily implemented using menu items as seen in the [sample](https://github.com/renaudcerrato/FloatingSearchView/blob/master/sample/src/main/java/com/mypopsy/floatingsearchview/MainActivity.java).
# Styling
`FloatingSearchView` do not expose most of TextView's XML attributes (`textColor`,`textSize`...). You can style them using theme attributes by applying [`app:theme`](https://chris.banes.me/2014/10/17/appcompat-v21) for example:
First, create a dedicated theme, possibly heriting from your application theme:
```xml
<item name="editTextStyle">@style/searchViewEditTextStyle</item>
<item name="android:divider">#c9c9c9</item>
<item name="android:dividerHeight">1dp</item>
<item name="colorControlNormal">#696969</item>
<item name="android:textSize">18sp</item>
<item name="android:textColor">?android:attr/textColorPrimary</item>
<item name="android:imeOptions">actionSearch</item>
```
Then, apply your custom theme through [`app:theme`](https://chris.banes.me/2014/10/17/appcompat-v21):
```xml
```
Look at the [sample](https://github.com/renaudcerrato/FloatingSearchView/blob/master/sample/src/main/java/com/mypopsy/floatingsearchview/MainActivity.java).
# Install
This repository can be found on JitPack:
https://jitpack.io/#renaudcerrato/FloatingSearchView
Add it in your root build.gradle at the end of repositories:
```
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
```
Add the dependency:
```
dependencies {
compile 'com.github.renaudcerrato:FloatingSearchView:1.0.1'
}
```