#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