Skip to content
Create fast, dynamic recycler views. No adapter, no view holders
Kotlin
Branch: master
Clone or download
Latest commit 8e70040 May 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app May need my own release, as owner is no longer responding Apr 29, 2019
fast-list Make an extra extension to use ViewPager2 May 14, 2019
.gitignore Null not needed Apr 9, 2019
LICENSE
README.md Merge pull request #14 from brh/master May 15, 2019
build.gradle Make an extra extension to use ViewPager2 May 14, 2019
gradle.properties init commit Jun 29, 2018
logo.png logoh Jun 29, 2018
settings.gradle init commit Jun 29, 2018

README.md

logo

Create dynamic, fast and easy recycler view lists (including ViewPager2). No adapters, no view holders.

Download Twitter URL

Usage

FastList supports 2 types of lists- single layout lists and dynamic lists.

  • Here's how to create a simple single layout list:
        val list = listOf(Item("fast", 1), Item("recycler", 2), Item("view", 1))

        recycler_view.bind(list, R.layout.item) { it : Item ->
            item_text.text = it.value
        }

That's it (for ViewPager2, just replace recycler_view with the ViewPager2 instance)! The first parameter is the list you want to show, the second is the ID of the layout and the third one is a function for binding each element. It uses Kotlin Extensions, so you can directly address the XML views and set them up.

  • The second type is dynamic lists with multiple layouts:
        val list = listOf(Item("fast", 1), Item("recycler", 2), Item("view", 1))

        recycler_view.bind(list)
                .map(layout = R.layout.item, predicate = { it.type == 1}) {
                    item_text.text = it.value
                }
                .map(layout = R.layout.item_second, predicate = { it.type == 2}) {
                    item_second_text.text = it.value
                }
                .layoutManager(LinearLayoutManager(this))

The map function accepts 3 parameters. The first is the ID of the layout for the type. The second is the predicate function by which you want to sort your items. The last one is the "view holder" binding function for each element. It uses Kotlin Extensions, so you can directly address the XML views and set them up.

If you need control over your view's creation, you can pass a factory that allows you to create your own view:

        val list = listOf(Item("fast", 1), Item("recycler", 2), Item("view", 1))

        recycler_view.bind(list)
                .map(layoutFactory = LocalFactory(this), predicate = { it.type == 1}) {
                    item_text.text = it.value
                }
                .map(layout = R.layout.item_second, predicate = { it.type == 2}) {
                    item_second_text.text = it.value
                }
                .layoutManager(LinearLayoutManager(this))
				...
	class LocalFactory(val activity: AppCompatActivity) : LayoutFactory {
		override fun createView(parent: ViewGroup, type: Int): View {
			val view = LayoutInflater.from(activity).inflate(R.layout.item,
					parent, false)
			//Manipulate view as needed 
			return view		
		}
	}				

You can also update a list in a shown recycler view with this DiffUtils update function:

        ...
        val list2 = listOf(Item("fast", 1))

        recycler_view.update(list2)

Download

Manually

You can also manually download the library class and use it in your application.

Important: For the manual download you need Kotlin extensions to be enabled. To turn them on, simply place "apply plugin: 'kotlin-android-extensions'" inside of your app build.gradle

Gradle

dependencies {
  implementation 'bg.devlabs.fastlist:fast-list:$latest_version'

}

Maven

<dependency>
  <groupId>bg.devlabs.fastlist</groupId>
  <artifactId>fast-list</artifactId>
  <version>latest_version</version>
  <type>pom</type>
</dependency>

Compatibility

Minimum Android SDK: API level 19


Author

Radoslav Yankov @Radoslav_Y


Getting help

If you spot a problem you can open an issue on the Github page, or alternatively, you can tweet us at @devlabsbg


License

FastList is released under the MIT License.

You can’t perform that action at this time.