Don't write a ViewPager Adapter! Hook up your ViewPager to your data model using Android Data Binding Framework.
Use the language of your choice.
// Java
new LastPagerAdapter(BR.model)
.add(R.layout.layout_one, "First Layout Title", modelObject1)
.add(R.layout.layout_two, "Second Layout Title", modelObject2)
.into(viewPager);
// Kotlin
viewpager.lastPagerAdapter(BR.model) {
add(R.layout.layout_one, "First Layout Title", modelObject1)
add(R.layout.layout_two, "Second Layout Title", modelObject2)
}
Download the demo apk to play around with the LastPagerAdapter demo app.
Or try the limited 1 min live app demo at Appetize.
LastPagerAdapter | |
---|---|
🚝 | Within a few lines easily hook up your data models with your ViewPager |
🔗 | Based on Android Data Binding |
✨ | Written in Kotlin. A concise language you should definitely check out, if you haven't already. |
✏️ | No need to write any PagerAdapter (FragmentPagerAdapter, etc.) |
⾹ | Doesn't rely on Fragments. It has complex lifecycle and best be avoided. More reasons why |
❌ | No need to modify your existing model classes |
📃 | Supports different View layouts and hooking it up with ViewPager is a breeze |
👌 | Super easy API. Concise syntax. Less Bugs for you to worry about. Boosted Productivity. |
📝 | Helpful error stacktraces |
🚀 | Very fast — no reflection |
📱 | Minimum Android SDK: Gingerbread API 9 |
Add this in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step 2. Add the dependency in your module's gradle file
// apply plugin: 'kotlin-kapt' // this line only for Kotlin projects
android {
...
dataBinding.enabled true
}
dependencies {
compile 'com.github.rakshakhegde:LastPagerAdapter:1.2'
// kapt 'com.android.databinding:compiler:GRADLE_PLUGIN_VERSION' // this line only for Kotlin projects
}
<layout>
as root for your View layouts is a must:
<layout xmlns:android="http://schemas.android.com/apk/res/android" >
<data>
<variable name="model" type="io.github.rakshakhegde.lastpageradaptersample.TextModel" />
</data>
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@{model.text}" />
</layout>
It is important for all the model types to have the same variable name, in this case "model". This name is passed to the adapter constructor as BR.variableName, in this case BR.model:
// Java
new LastPagerAdapter(BR.model)
.add(R.layout.text_layout, "Optional Layout Title", optionalTextModelObject, optionalWidth)
.into(viewPager); // don't forget this line
// Kotlin
viewpager.lastPagerAdapter(BR.model) {
add(R.layout.text_layout, "Optional Layout Title", optionalTextModelObject, optionalWidth)
}
Except the layoutId, everything else is optional
And that is how easy it is. Download the demo apk to play around with the LastPagerAdapter demo app.
- Customizability in terms of having independent names for models in XML is not present
- API seems a bit verbose for large number of similar views. Could implement a version which accepts arrays. Anyways, a loop could be used there.
- Callbacks for creation or destruction of Views is not implemented (I didn't implement them because personally my use case didn't require it). Feel free to Pull Request this one.
Library and API Structure inspired from LastAdapter
Library Concept inspired from SmartTabLayout's Utils
Logo and Hero Banner created by Govindaraj Karthikeyan. Check him out on Bēhance
Core Logo created using Roman Nurik's awesome Android Asset Studio 🔥🔥🔥
Catch me at @rakshakhegde
Email | Twitter | Facebook | Google+ | Linked.in
Please file bugs, suggest improvements and feel free to contribute
💋 Keep It Simple Silly
- v1.2
- Documentation Update
- Upgraded internal working
- Updated library versions
- Fix AndroidManifest
Copyright 2017 Rakshak Hegde
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.