Skip to content
/ search Public
forked from lapism/search

Material Design Search component for Android, SearchView

License

Notifications You must be signed in to change notification settings

zioolek/search

 
 

Repository files navigation

Download License API

Search

  • Material Design Search component for Android
  • Last Google Material Design
  • Styling
  • Kotlin

Material Design pattern:
https://material.io/design/navigation/search.html

Versions history:
https://bintray.com/lapism/maven/search

Search

Apps with this library

Sdk

minSdkVersion 21, targetSdkVersion 30, Java 1.8, Kotlin 1.8

Add the dependency to your gradle file:

dependencies {
    implementation 'com.lapism:search:2.2.0@aar'
}

Usage

Code example

        val materialSearchView = findViewById<MaterialSearchView>(R.id.materialSearchView)
        materialSearchView.apply {
            setAdapterLayoutManager(layoutManager)
            setAdapter(adapter)

            navigationIconSupport = SearchLayout.NavigationIconSupport.SEARCH
            setOnNavigationClickListener(object : SearchLayout.OnNavigationClickListener {
                override fun onNavigationClick() {
                    materialSearchView.requestFocus()
                }
            })

            setTextHint(getString(R.string.search))
            setOnQueryTextListener(object : SearchLayout.OnQueryTextListener {
                override fun onQueryTextChange(newText: CharSequence): Boolean {
                    adapter.filter(newText)
                    return true
                }

                override fun onQueryTextSubmit(query: CharSequence): Boolean {
                    return true
                }
            })

            setMicIconImageResource(R.drawable.ic_outline_mic_none_24dp)
            setOnMicClickListener(object : SearchLayout.OnMicClickListener {
                override fun onMicClick() {
                    if (SearchUtils.isVoiceSearchAvailable(this@MainActivity)) {
                        SearchUtils.setVoiceSearch(
                            this@MainActivity,
                            getString(R.string.speak)
                        )
                    }
                }
            })

            setMenuIconImageResource(R.drawable.layer_list_settings)
            setOnMenuClickListener(object : SearchLayout.OnMenuClickListener {
                override fun onMenuClick() {

                }
            })

            elevation = 0f
            setBackgroundStrokeWidth(resources.getDimensionPixelSize(R.dimen.search_stroke_width))
            setBackgroundStrokeColor(
                ContextCompat.getColor(
                    this@MainActivity,
                    R.color.divider
                )
            )
            setOnFocusChangeListener(object : SearchLayout.OnFocusChangeListener {
                override fun onFocusChange(hasFocus: Boolean) {
                    if (hasFocus) {
                        navigationIconSupport = SearchLayout.NavigationIconSupport.ARROW
                    } else {
                        navigationIconSupport = SearchLayout.NavigationIconSupport.SEARCH
                    }
                }
            })
        }

Layout example

It must be in the CoordinatorLayout. Also add android:stateListAnimator="@null" to the AppBarLayout.

        <?xml version="1.0" encoding="utf-8"?>
        <androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto"
            xmlns:tools="http://schemas.android.com/tools"
            android:layout_width="match_parent"
            android:layout_height="match_parent">

            <com.google.android.material.appbar.AppBarLayout
                android:layout_width="match_parent"
                android:layout_height="wrap_content"

                android:stateListAnimator="@null">

                <include layout="@layout/include_material_toolbar" />

            </com.google.android.material.appbar.AppBarLayout>

            <androidx.viewpager2.widget.ViewPager2
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:overScrollMode="never"
                app:layout_behavior="@string/appbar_scrolling_view_behavior" />

            <com.lapism.search.widget.MaterialSearchView
                android:id="@+id/material_search_view"
                android:layout_width="match_parent"
                android:layout_height="wrap_content" />

            <include layout="@layout/include_bottom_nav" />

        </androidx.coordinatorlayout.widget.CoordinatorLayout>

XML attributes

        <attr name="search_navigation_icon_support" format="enum">
            <enum name="none" value="1000" />
            <enum name="menu" value="1001" />
            <enum name="arrow" value="1002" />
            <enum name="search" value="1003" />
        </attr>

Changelog

2.2.0

  • API 30
  • fixed bottom margin bug with elevation more than 0dp
  • dependencies update
  • fixed transition animation on API 30

2.1.3

  • margin null type

2.1.2

  • fixed transition animation

2.1.1

  • fixed elevation bug in CoordinatorLayout
  • SearchBehavior Z now depends on LinearLayout and BottomNavigationView :-)

2.1.0

  • fixed focus animation
  • small improvements
  • fixed bugs
  • SearchBehavior Z now depends on AppBarLayout, LinearLayout and BottomNavigationView
  • added public method MaterialSearchView.setTransitionDuration
  • added public method MaterialSearchView.setClearFocusOnBackPressed
  • added public.xml file

2.0.0

  • SearchMenu item removed
  • SearchView renamed to MaterialSearchView
  • changed NavigationIconSupport properties
  • NavigationIconSupport properties moved to SearchLayout
  • fixed bugs
  • improved open and hide animation
  • new public methods

Author

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

About

Material Design Search component for Android, SearchView

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 100.0%