dinukapj/MaterialSearchBar

Material Design Search Bar for Android

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.dinukapj:MaterialSearchBar:0.7.2'
	}

	dependencies {
		implementation("com.github.dinukapj:MaterialSearchBar:0.7.2")
	}

	<dependency>
	    <groupId>com.github.dinukapj</groupId>
	    <artifactId>MaterialSearchBar</artifactId>
	    <version>0.7.2</version>
	</dependency>


                            
    libraryDependencies += "com.github.dinukapj" % "MaterialSearchBar" % "0.7.2"


                            
    :dependencies [[com.github.dinukapj/MaterialSearchBar "0.7.2"]]

Readme

#Material SearchBar Android Material Design Search Bar for Android

This beautiful and easy to use library will help to add Lollipop Material Design SearchView in your project.

See our Wiki

#How to use

to include SearchBar to your project:

add this code to the the project level build.gradle file

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

add the dependency to the the app level build.gradle file

dependencies {
	compile 'com.github.mancj:MaterialSearchBar:0.7.1'
}

then add SearchBar to your activity:

<com.mancj.materialsearchbar.MaterialSearchBar
    app:mt_speechMode="true"
    app:mt_hint="Custom hint"
    app:mt_maxSuggestionsCount="10"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:id="@+id/searchBar" />

MaterialSarchBar has the following xml attributes:

| attribute | description | |---------------------|---------------------------------------------------------------------------------------| | mt_hint | Set custom prompt in the search box | | mt_speechMode | If set to true, microphone icon will display instead of the search icon. | | mt_maxSuggestionsCount | Specifies the maximum number of search queries stored until the activity is destroyed | | mt_searchIconDrawable | Set search icon drawable resource | | mt_navIconDrawable | Set navigation icon drawable resource | | mt_textColor | Change text color | | mt_hintColor | Change text hint color | | mt_navIconEnabled | Set navigation icon enabled | | mt_placeholder | Set the place holder text before any click is performed to |

public methods:

disableSearch()
enableSearch()
isSearchEnabled()
setText(String text)
getText()
setHint(CharSequence hint)
setNavButtonEnabled(boolean navButtonEnabled)
setSpeechMode(boolean speechMode)
setOnSearchActionListener(OnSearchActionListener onSearchActionListener)
setLastSuggestions(List<String> suggestions)
getLastSuggestions()
setMaxSuggestionCount(int maxQuery)
setSearchIcon(int searchIconResId)
setNavigationIcon(int navigationIconResId)
setTextColor(int textColor)
setTextHintColor(int hintColor)
inflateMenu(int menuResource)
getMenu()
addTextChangeListener(TextWatcher textWatcher)
setCardViewElevation(int elevation)
setPlaceHolder(CharSequence placeholder)
setSuggstionsClickListener
updateLastSuggestions
setCustomSuggestionAdapter

To save search queries when the activity is destroyed, use the method searchBar.getLastSuggestions() and then, to restore them use searchBar.setLastSuggestions(List<String>); as shown in the example below

#Example

Here is a simple example of using MaterialSearchBar

private List<String> lastSearches;
private MaterialSearchBar searchBar;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    searchBar = (MaterialSearchBar) findViewById(R.id.searchBar);
    searchBar.setHint("Custom hint");
    searchBar.setSpeechMode(true);
    //enable searchbar callbacks
    searchBar.setOnSearchActionListener(this);
    //restore last queries from disk
    lastSearches = loadSearchSuggestionFromDisk();
    searchBar.setLastSuggestions(list);
    //Inflate menu and setup OnMenuItemClickListener
    searchBar.inflateMenu(R.menu.main);
    searchBar.getMenu().setOnMenuItemClickListener(this);
}

@Override
protected void onDestroy() {
    super.onDestroy();
    //save last queries to disk
    saveSearchSuggestionToDisk(searchBar.getLastSuggestions());
}

@Override
public void onSearchStateChanged(boolean enabled) {
    String s = enabled ? "enabled" : "disabled";
    Toast.makeText(MainActivity.this, "Search " + s, Toast.LENGTH_SHORT).show();
}

@Override
public void onSearchConfirmed(CharSequence text) {
    startSearch(text.toString(), true, null, true);
}

@Override
public void onButtonClicked(int buttonCode) {
    switch (buttonCode){
        case MaterialSearchBar.BUTTON_NAVIGATION:
            drawer.openDrawer(Gravity.LEFT);
            break;
        case MaterialSearchBar.BUTTON_SPEECH:
            openVoiceRecognizer();
    }
}

More Examples