LastPagerAdapter

Don't write a ViewPager Adapter! Hook up your ViewPager to your data model using Android Data Binding Framework. With Kotlin support!

Programming language: Kotlin

License: Apache License 2.0

Tags: Kotlin     ViewPager Widget     Utility     Data binding     Libraries     ViewPager     Productivity     Anko    

Latest version: v1.2

README

Don't write a ViewPager Adapter! Hook up your ViewPager to your data model using Android Data Binding Framework.

Show some :heart:

:kiss: Sweet and short library

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.

:crown: Features

	LastPagerAdapter
:monorail:	Within a few lines easily hook up your data models with your ViewPager
:link:	Based on Android Data Binding
:sparkles:	Written in Kotlin. A concise language you should definitely check out, if you haven't already.
:pencil2:	No need to write any PagerAdapter (FragmentPagerAdapter, etc.)
⾹	Doesn't rely on Fragments. It has complex lifecycle and best be avoided. More reasons why
:x:	No need to modify your existing model classes
:page_with_curl:	Supports different View layouts and hooking it up with ViewPager is a breeze
:ok_hand:	Super easy API. Concise syntax. Less Bugs for you to worry about. Boosted Productivity.
:memo:	Helpful error stacktraces
:rocket:	Very fast — no reflection
:iphone:	Minimum Android SDK: Gingerbread API 9

:classical_building: Build

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
}

:thinking: How to use

<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.

:-1: Known Issues

• 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.

:sparkles: My Recommended Repos

• DaggerAndroidInjector
• Diffre

:sparkles: Acknowledgements

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 :fire::fire::fire:

:man_cartwheeling: Author

Catch me at @rakshakhegde

Email | Twitter | Facebook | Google+ | Linked.in

:fork_and_knife: Contribute

Please file bugs, suggest improvements and feel free to contribute

:kiss: Keep It Simple Silly

Changelog

• v1.2
  • Documentation Update
  • Upgraded internal working
  • Updated library versions
  • Fix AndroidManifest

:memo: License

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.