A RecyclerView built for Android TV as a replacement for Leanback's BaseGridView.
See the project website for more information: https://rubensousa.github.io/DpadRecyclerView
Motivation for this library: https://rubensousa.com/2022/11/08/dpadrecyclerview/
Check the sample app for a complete example of integration of this library:
Add the following dependency to your app's build.gradle
:
implementation "com.rubensousa.dpadrecyclerview:dpadrecyclerview:$latestVersion"
// Recommended: To use Compose together with DpadRecyclerView
implementation "com.rubensousa.dpadrecyclerview:dpadrecyclerview-compose:$latestVersion"
// Optional: Espresso test helpers for your instrumented tests:
androidTestImplementation "com.rubensousa.dpadrecyclerview:dpadrecyclerview-testing:$latestVersion"
Check the official website for more information and recipes: https://rubensousa.github.io/DpadRecyclerView
- Supports grids with different span sizes
- Supports infinite/endless scrolling
- Supports reverse layout
- XML attributes for easier configuration
- Supports changing the alignment configuration smoothly
- Supports limiting the number of pending alignments
- Supports non smooth scroll changes
- Supports continuous and circular grid focus
Documentation: https://rubensousa.github.io/DpadRecyclerView/compose/
class ComposeItemAdapter(
private val onItemClick: (Int) -> Unit
) : ListAdapter<Int, DpadComposeFocusViewHolder<Int>>(Item.DIFF_CALLBACK) {
override fun onCreateViewHolder(
parent: ViewGroup,
viewType: Int
): DpadComposeFocusViewHolder<Int> {
return DpadComposeFocusViewHolder(parent) { item ->
ItemComposable(
item = item,
onClick = {
onItemClick(item)
}
)
}
}
override fun onBindViewHolder(
holder: DpadComposeFocusViewHolder<Int>,
position: Int
) {
holder.setItemState(getItem(position))
}
}
Nested lists:
focus_overlay.webm
Grid with different span sizes:
Copyright 2024 Rúben Sousa
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.