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: 1 day ago
JSON representation

Yet another floating search view implementation, also known as persistent search.

Lists

README 

        
# FloatingSearchView [![](https://img.shields.io/badge/android%20weekly-%23186-yellow.svg)](http://androidweekly.net/issues/issue-186) [![](https://jitpack.io/v/renaudcerrato/FloatingSearchView.svg)](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'

	}

```