Skip to content

Latest commit

 

History

History
executable file
·
201 lines (178 loc) · 8.37 KB

README.md

File metadata and controls

executable file
·
201 lines (178 loc) · 8.37 KB

SearchView

Persistent SearchView Library from Play Store.
Features: Material Design, Toolbar / Menu item version, History, Styling.

Google Material Design Pattern:
https://material.io/guidelines/patterns/search.html
Version history here:
https://bintray.com/lapism/maven/searchview/view
Material colors in the project:
https://gist.github.com/lapism/3b417142300d9dbde3b4

Donations:

Please support me !

Get it on Google Play

Apps using this library:
Because I have done firstly this library as a private project, I would like to know if someone of you use my library in your application. If yes, please send me a name of your app and link to Play Store and I will promote your app in Readme.

Service Notes
Business Card Reader
Toiletto
Zikobot
AllWeather
Karaoke Online Sing & Record
Playbuzz
MovieTracker
MaxTorz
RealTime Subscriber YouTube
Lucidity - Lucid Dream Journal
Guide COC


Usage

Add the dependencies to your gradle file:

dependencies {
    implementation 'com.lapism:searchview:5.0.0-alpha4'
}

Screenshot 1
Screenshot 2

Versions:

SearchView identifies its layout style through versions. Currently, there are two values, namely SearchView.Version.TOOLBAR for the persistent view, and SearchView.Version.MENU_ITEM for the view that appears on a menuitem press. The version may be defined through setVersion.

SearchView.Version.MENU_ITEM and SearchView.Version.TOOLBAR:

        SearchHistoryTable mHistoryDatabase = new SearchHistoryTable(this);

        SearchView mSearchView = (SearchView) findViewById(R.id.searchView); // to API 25
        SearchView mSearchView = findViewById(R.id.searchView); // from API 26
        if (mSearchView != null) {
            mSearchView.setVersionMargins(SearchView.VersionMargins.TOOLBAR_SMALL);
            mSearchView.setHint(R.string.search);
            mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
                @Override
                public boolean onQueryTextSubmit(String query) {
                    mHistoryDatabase.addItem(new SearchItem(query));
                    mSearchView.close(false);
                    return true;
                }

                @Override
                public boolean onQueryTextChange(String newText) {
                    return false;
                }
            });
            mSearchView.setOnOpenCloseListener(new SearchView.OnOpenCloseListener() {
                @Override
                public boolean onOpen() {
                    if (mFab != null) {
                        mFab.hide();
                    }
                    return true;
                }

                @Override
                public boolean onClose() {
                    if (mFab != null && !mDrawerLayout.isDrawerOpen(GravityCompat.START)) {
                        mFab.show();
                    }
                    return true;
                }
            });
            mSearchView.setVoiceText("Set permission on Android 6.0+ !");
            mSearchView.setOnVoiceIconClickListener(() -> {
                // permission
            });

            List<SearchItem> suggestionsList = new ArrayList<>();
            suggestionsList.add(new SearchItem("search1"));
            suggestionsList.add(new SearchItem("search2"));
            suggestionsList.add(new SearchItem("search3"));

            SearchAdapter searchAdapter = new SearchAdapter(this, suggestionsList);
            searchAdapter.setOnSearchItemClickListener((view, position) -> {
                TextView textView = (TextView) view.findViewById(R.id.textView);
                String query = textView.getText().toString();
                mHistoryDatabase.addItem(new SearchItem(text));
                mSearchView.close(false);
            });
            mSearchView.setAdapter(searchAdapter);

            suggestionsList.add(new SearchItem("search1"));
            suggestionsList.add(new SearchItem("search2"));
            suggestionsList.add(new SearchItem("search3"));
            searchAdapter.notifyDataSetChanged();
            
            List<SearchFilter> filter = new ArrayList<>();
            filter.add(new SearchFilter("Filter1", true));
            filter.add(new SearchFilter("Filter2", true));
            mSearchView.setFilters(filter);
            //use mSearchView.getFiltersStates() to consider filter when performing search
        }

SearchView.Version.MENU_ITEM:

        @Override
        public boolean onOptionsItemSelected(MenuItem item) {
            switch (item.getItemId()) {
                case R.id.action_search: {
                    mSearchView.open(true/false); // enable or disable animation
                    return true;
                }
                default:
                    return super.onOptionsItemSelected(item);
            }
        }

XML:

<com.lapism.searchview.SearchView
    android:id="@+id/searchView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

XML with CoordinatorLayout:

<com.lapism.searchview.SearchView
    android:id="@+id/searchView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" 
    app:layout_behavior="com.lapism.searchview.SearchBehavior" />

Styling SearchView:

<attr name="search_version" format="enum">
    <enum name="toolbar" value="1000" />
    <enum name="menu_item" value="1001" />
</attr>
<attr name="search_version_margins" format="enum">
    <enum name="toolbar_small" value="2000" />
    <enum name="toolbar_big" value="2001" />
    <enum name="menu_item" value="2002" />
</attr>
<attr name="search_theme" format="enum">
    <enum name="light" value="3000" />
    <enum name="dark" value="3001" />
    <enum name="play_store" value="3002" />
</attr>
<attr name="search_height" format="dimension" />
<attr name="search_navigation_icon" format="integer" />
<attr name="search_icon_color" format="color" />
<attr name="search_background_color" format="color" />
<attr name="search_text_color" format="color" />
<attr name="search_text_highlight_color" format="color" />
<attr name="search_text_size" format="dimension" />
<attr name="search_text_style" format="enum">
    <enum name="normal" value="0" />
    <enum name="bold" value="1" />
    <enum name="italic" value="2" />
    <enum name="bold_italic" value="3" />
</attr>
<attr name="search_hint" format="string" />
<attr name="search_hint_color" format="color" />
<attr name="search_voice" format="boolean" />
<attr name="search_voice_text" format="string" />
<attr name="search_animation_duration" format="integer" />
<attr name="search_shadow" format="boolean" />
<attr name="search_shadow_color" format="boolean" />
<attr name="search_elevation" format="dimension" />
<attr name="search_clear_on_open" format="boolean" />
<attr name="search_clear_on_close" format="boolean" />
<attr name="search_hide_on_keyboard_close" format="boolean" />
<attr name="search_cursor_drawable" format="integer" />