OneAdapter alternatives and similar packages
Based on the "Other Widget" category.
Alternatively, view OneAdapter alternatives based on common mentions on social networks and blogs.
-
AndroidSlidingUpPanel
This library provides a simple way to add a draggable sliding up panel (popularized by Google Music and Google Maps) to your Android application. Brought to you by Umano. -
BottomBar
(Deprecated) A custom view component that mimics the new Material Design Bottom Navigation pattern. -
ShortcutBadger
An Android library supports badge notification like iOS in Samsung, LG, Sony and HTC launchers. -
Litho (By Facebook)
A declarative framework for building efficient UIs on Android. -
SystemBarTint
[DEPRECATED] Apply background tinting to the Android system UI when using KitKat translucent modes -
DragSortListView
Android ListView with drag and drop reordering. -
TapTargetView
An implementation of tap targets from the Material Design guidelines for feature discovery. -
android-viewbadger
[DEPRECATED] A simple way to "badge" any given Android view at runtime without having to cater for it in layout -
AndroidViewHover
An elegant way to show your menu or messages. -
android-stackblur
Android StackBlur is a library that can perform a blurry effect on a Bitmap based on a gradient or radius, and return the result. The library is based on the code of Mario Klingemann. -
android-iconify
Android integration of multiple icon providers such as FontAwesome, Entypo, Typicons,... -
DraggablePanel
Android library used to create an awesome Android UI based on a draggable element similar to the last YouTube graphic component. -
android-pdfview
[DEPRECATED] A fast PDF reader component for Android development -
android-pathview
Android view with both path from constructed path or from svg. -
AndroidTreeView
AndroidTreeView. TreeView implementation for android -
aFileChooser
[DEPRECATED] Android library that provides a file explorer to let users select files on external storage. -
Swipecards
A Tinder-like Android library to create the swipe cards effect. You can swipe left or right to like or dislike the content. -
android-viewflow
A horizontal view scroller library for Android -
TourGuide
TourGuide is an Android library that aims to provide an easy way to add pointers with animations over a desired Android View -
MaterialIntroScreen
Inspired by Heinrich Reimer Material Intro and developed with love from scratch -
Flow
Name UI states, navigate between them, remember where you've been. -
MultiSnapRecyclerView
Android library for multiple snapping of RecyclerView -
chromeview
Android WebView implementation that uses the latest Chromium code -
android-segmented-control
ios UISegmentedControl for android -
StickyGridHeaders
An Android Library that makes it easy to make grid views with sectioned data and headers that stick to the top. -
FloatingView
FloatingView can make the target view floating above the anchor view with cool animation -
HoloColorPicker
An Android Holo themed colorpicker designed by Marie Schweiz -
TileView
TileView is a subclass of android.view.ViewGroup that asynchronously displays, pans and zooms tile-based images. Plugins are available for features like markers, hotspots, and path drawing. -
Android-SwipeToDismiss
Android swipe-to-dismiss mini-library and sample code -
StandOut
StandOut lets you easily create floating windows in your Android app. -
Flashbar
⚡️A highly customizable, powerful and easy-to-use alerting library for Android. -
Bubbles for Android
Bubbles for Android is an Android library to provide chat heads capabilities on your apps. With a fast way to integrate with your development. -
FancyCoverFlow
A cool Open Source CoverFlow view for Android with several fancy effects. -
Emoji
A library to add Emoji support to your Android / JVM Application -
SwipeStack
A simple, customizable and easy to use swipeable view stack for Android. -
RippleView
View that imitates Ripple Effect on click which was introduced in Android L (for Android 2.3+) -
Android-ActionItemBadge
This library offers a simple method to add a small badge icon to your ActionBar-MenuItem -
android-sliding-layer-lib
Highly customizable SlidingLayer as you have seen in Wunderlist -
SortableTableView
An Android library containing a simple TableView and an advanced SortableTableView providing a lot of customisation possibilities to fit all needs. -
ScratchView
ScratchView repo is UX Design involving scratch cards like views which are scratched to reveal the information they conceal. -
SwipeSelector
A nicer-looking, more intuitive and highly customizable alternative for radio buttons and dropdowns for Android.
Appwrite - The open-source backend cloud platform
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of OneAdapter or a related project?
README
[Logo](DEV/logo.png)
OneAdapter
OneAdapter is made to simplify and enhance the use of the RecyclerView's Adapter while preventing common mistakes. With multiple modules and hooks, you don't have to think about writing an adapter anymore, and just focus on what matters.
For better understanding what drove me to write this library and what use cases it solves best, please refer to my Medium post: https://medium.com/@idanatsmon/adapting-your-recyclerview-the-2019-approach-e47edf2fc4f3
What's new:
Version 2.0.0 is out with a brand new Kotlin API! Kotlin is now the first priority of this library and as such comes a full API change, every Module, Hook and State is now created using dedicated DSLs. Check the example below or sample project for reference for Kotlin & Java use.
Features:
- Modular approach for more reusable and testable code
- Built-in support for DiffUtil (using Diffable)
- Optimized performance - internal processing done on a background thread
- 100% written in Kotlin with Kotlin friendly API using DSLs
- Modules:
- Event Hooks:
- Others:
Include in your project
Root build.gradle:
allprojects {
repositories {
jcenter()
maven { url "https://jitpack.io" }
}
}
App build.gradle:
dependencies {
implementation "com.github.idanatz:OneAdapter:${LATEST_VERSION}"
}
Note that library interfaces and API may change slightly while the library design matures. Please see the changes in the CHANGELOG file before upgrading.
Preview
Example
You can try out the example project that includes basic and advanced usage in Kotlin.
Screenshots
Basic Usage
1. Implement Item Module
Item Modules are used for the creation and binding of all ViewHolders for you. In the onBind method, you will receive as a parameter the model associated with this view and a ViewBinder class that lets you find (and cache) the views defined in the associated layout file.
class MessageModule : ItemModule<MessageModel>() {
init {
config {
layoutResource = R.layout.message_model
}
onBind { model, viewBinder, metadata ->
val title = viewBinder.findViewById<TextView>(R.id.title)
title.text = model.title
}
onUnbind { model, viewBinder, metadata ->
// unbind logic like stop animation, release webview resources, etc.
}
}
}
2. Implement Diffable
The Adapter is calculating the difference between its current data and the modified data on a background thread and posting the result to the main thread. In order for this magic to work without writing tons of DiffUtil.Callback, your models need to implement one simple interface:
class MessageModel : Diffable {
private val id: Long = 0L
private val title: String? = null
override val uniqueIdentifier: Long = id
override fun areContentTheSame(other: Any): Boolean = other is MessageModel && title == other.title
}
3. Attach To OneAdapter & Use
val oneAdapter = OneAdapter(recyclerView) {
itemModule += MessageModule()
}
oneAdapter.setItems(...)
Advanced Usage
Modules
Multiple Types
Have more than one view type? not a problem, just create another ItemModule and attach it to OneAdapter in the same way.
1. Implement Multiple Item Modules
class MessageModule : ItemModule<MessageModel> { ... }
class StoryModule : ItemModule<StoryModel> { ... }
2. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
itemModule += MessageModule()
itemModule += StoryModule()
...
}
Paging Module
Paging Module is used for creating and binding a specific ViewHolder at the end of the list when the Adapter reaches a load more state. The visible threshold configuration is used to indicate how many items before the end of the list the onLoadMore callback should be invoked.
1. Implement Paging Modules
class PagingModuleImpl : PagingModule() {
init {
config {
layoutResource = R.layout.load_more // can be some spinner animation
visibleThreshold = 3 // invoke onLoadMore 3 items before the end
}
onLoadMore { currentPage ->
// place your load more logic here, like asking the ViewModel to load the next page of data.
}
}
}
2. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
// itemModule += ...
pagingModule = PagingModuleImpl()
}
Emptiness Module
Emptiness Module is used for creating and binding a specific ViewHolder when the Adapter has no data to render.
1. Implement Emptiness Modules
class EmptinessModuleImpl : EmptinessModule() {
init {
config {
layoutResource = R.layout.empty_state
}
onBind { viewBinder, metadata -> ... }
onUnbind { viewBinder, metadata -> ... }
}
}
2. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
// itemModule += ...
emptinessModule = EmptinessModuleImpl()
}
Selection Module
Selection Module is used for enabling single or multiple selection on Items.
1. Implement Selection Modules
class ItemSelectionModuleImpl : ItemSelectionModule() {
init {
config {
selectionType = SelectionType.Multiple // Or SelectionType.Single
}
onStartSelection {
// place your general selection logic here, like changing the toolbar text to indicate the selected count.
}
onUpdateSelection { selectedCount -> ... }
onEndSelection { ... }
}
}
2. Implement Selection State
class MessageModule : ItemModule<MessageModel>() {
init {
// config, onBind, etc...
states += SelectionState<MessageModel>().apply {
config {
enabled = true // decide if the selection should be enabled for this model, true by default
selectionTrigger = SelectionTrigger.LongClick // decide what trigger the selection, long or regular click
}
onSelected { model, selected ->
// insert your selected logic here.
// right after this call you will receive an onBind call in order to reflect your changes on the relevant Item Module.
}
}
}
}
3. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
itemModule += MessageModule()
itemSelectionModule = ItemSelectionModuleImpl()
}
Event Hooks
Item Modules can easily be enhanced with event hooks to get access to common events like clicking or swiping on an item.
Click Event Hook
Click Hook can be attached in order to recieve click events on an item.
1. Implement Click Event Hook
class MessageModule : ItemModule<MessageModel>() {
init {
// config, onBind, etc...
eventHooks += ClickEventHook<MessageModel>().apply {
onClick { model, viewBinder, metadata ->
// place your on click logic here.
}
}
}
}
2. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
itemModule += MessageModule()
}
Swipe Event Hook
Swipe Hook can be attached in order to receive swiping (during and when completed) events on an item.
1. Implement Swipe Event Hook
class MessageModule : ItemModule<MessageModel>() {
init {
// config, onBind, etc...
eventHooks += SwipeEventHook<MessageModel>().apply {
config {
swipeDirection = listOf(SwipeEventHook.SwipeDirection.Start, SwipeEventHook.SwipeDirection.End)
}
onSwipe { canvas, xAxisOffset, viewBinder ->
// draw your swipe UI here.
// like painting the canvas red with a delete icon.
}
onSwipeComplete { model, viewBinder, metadata ->
// place your swipe logic here.
// like removing an item after it was swiped right.
}
}
}
}
2. Attach To OneAdapter
val oneAdapter = OneAdapter(recyclerView) {
itemModule += MessageModule()
}
Others
First Bind Animation
The provided Animator will be animated on the first bind of the corresponding ItemModule's models.
class MessageModule : ItemModule<MessageModel>() {
init {
config {
layoutResource = R.layout.message_model
// can be implemented by inflating Animator Xml
firstBindAnimation = AnimatorInflater.loadAnimator(this@FirstBindAnimationActivity, R.animator.item_animation_example)
// or can be implemented by constructing ObjectAnimator
firstBindAnimation = ObjectAnimator().apply {
propertyName = "translationX"
setFloatValues(-1080f, 0f)
duration = 750
}
}
onBind { model, viewBinder, metadata -> ... }
}
}
View Binding
Built in support for Android View Binding (https://developer.android.com/topic/libraries/view-binding) Full example is provided in the example project.
class MessageModule : ItemModule<MessageModel>() {
init {
config {
layoutResource = R.layout.message_model
}
onBind { model, viewBinder, _ ->
viewBinder.bindings(MessageModelBinding::bind).run {
title.text = model.title
body.text = model.body
Glide.with(viewBinder.rootView).load(model.avatarImageId).into(avatarImage)
}
}
}
}
Data Binding
Built in support for Android Data Binding (https://developer.android.com/topic/libraries/data-binding) Full example is provided in the example project.
class MessageModule : ItemModule<ObservableMessageModel>() {
init {
config {
layoutResource = R.layout.message_model
}
onBind { model, viewBinder, metadata ->
viewBinder.dataBinding?.run {
setVariable(BR.messageModel, model)
lifecycleOwner = this@DataBindingActivity
executePendingBindings()
}
}
}
}
License
Copyright (c) 2019 Idan Atsmon
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*Note that all licence references and agreements mentioned in the OneAdapter README section above
are relevant to that project's source code only.