Why Not! Image Carousel! Version 2 released! It’s time for an Infinite Carousel!
Why Not! Image Carousel! Version 2 released! 😃 In this post, I will discuss some of the new features and some challenges I face during coding it.
What’s new in version 2?
There are many new features, changes, and modifications that come with version 2. Notable features/changes are —
- Custom view with View Binding support.
- Infinite carousel support.
- Touch-to-pause support.
- Carousel view gravity added so that the view can be aligned from start.
ImageCarousel
is now a lifecycle-aware component.- More use cases and inspiring samples were added.
The full release note can be found here. Let’s discuss some of the features.
Custom view with View Binding support
The age of findViewById()
is long gone, now View-Binding is the recommended way for handling/accessing views. So we removed the old custom layout system and added View-Binding supported custom layout system. It’s straightforward. Example code:
For Java example see the readme of the library. Here we just inflate the view and bind the view with data like the implementation of the RecyclerView
Adapter. So simple isn’t it! 😎
Using the custom view you can use the carousel without any image. For this, you can use blank CarouselItem
objects. See the samples for an example like this.
♾ Infinite carousel support
The library now supports item looping, which we called an infinite carousel. This feature currently is the default for the carousel. If you need you can disable it by setting infiniteCarousel
to false
.
Creating a looping list using RecyclerView
is simple. Just override getItemCount()
method in the RecyclerView
Adapter. Example code:
override fun getItemCount(): Int {
return if (dataList.isEmpty()) 0 else Integer.MAX_VALUE
}override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
val item = dataList[position % dataList.size]
// …
}
Then at the start just scroll to the middle point of the list to make it feel like it’s infinite.
recyclerView.scrollToPosition(Integer.MAX_VALUE / 2)
But the challenge is, for CarouselType.SHOWCASE
, the current position item view is not get centered automatically! We could use scrollToPosition()
method with smoothScrollToPosition()
to make it center. But it is not smooth and creates bugs. When the first time the view is loaded you will see some glitch 😐. So to solve this, we used the scrollToPositionWithOffset()
method and manually calculated the offset.
val view = layoutManager.findViewByPosition(0)layoutManager.scrollToPositionWithOffset(
finalPosition,
recyclerView.width / 2 - view.width / 2
)
See the source for details.
✨ Touch-to-pause support
If auto-play is turned on, then on touch down 👇 it will be paused and will be resumed on touch up ☝. I first tried it with recyclerView.setOnTouchListener()
method, but it does not receive ACTION_DOWN
event! Finally, I override the onInterceptTouchEvent()
method to solve the problem. See the source for details.
There is a limitation though if the user touches down and swipes to left or right, the carousel will not resume. But you can resume it just by touching the carousel again. If you find any solution to this limitation then give me a PR. 🎈
🌿 “ImageCarousel” is now a lifecycle-aware component
Android introduced lifecycle-aware components to bind any component with the lifecycle of an Activity or Fragment or any Lifecycle-Owner. ImageCarouse
is now a lifecycle-aware component. You should register lifecycle using the registerLifecycle()
method. For Activity the parameter will be lifecycle
/getLifecycle()
and for Fragment it will be viewLifecycleOwner
/getViewLifecycleOwner()
.
It is recommended if you enabled auto-play & infinite carousel. so that the auto-play/scroll will pause when the app is in the background. It is also used to correctly initialize the infinite carousel when the app is in the background.
💡 More use cases and inspiring samples
The samples are refreshed and added more use-cases and inspiring examples. Check out the samples here.
What next… 🤔
Try it… Clone it… Fork it… Check out the library source code… Give us suggestions, ideas, PRs…
Finally, share the library with your friends and colleagues 😁.