Swap between many different Android Views within your app quick and easy.
iOS developer? Check out the iOS version of Swapper!
You know those moments in your app when you have a RecyclerView that has no rows to show? You know those moments when you perform a HTTP network request and you want to show a non-blocking loading view to the user? These are very common scenarios for mobile apps. Swapper is an Android View that allows you to swap between a set of other Viewss with just 1 line of code.
- Kotlin API
- Lightweight. Zero dependencies.
- UI testing friendly.
- Setup with default values that should work for 95% of your use cases. Fully customizable for those other cases.
- Strict semantic versioning for backwards compatibility.
- Example app in this project to learn from.
I recommend you check out 2 other libraries that work nicely with Swapper: Empty and PleaseHold.
To install Swapper, simply add the following line to your build.gradle file:
implementation 'com.levibostian.swapper:swapper:version-goes-here'
Replace version-here with:
- Add an instance of
SwapperViewto your layout. Add all of the views that you want to swap between as children ofSwapperView.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.levibostian.swapper.SwapperView
android:id="@+id/swapper_view"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/first_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
<ImageView
android:id="@+id/second_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</com.levibostian.swapper.SwapperView>
</LinearLayout>Note: The views you want to swap between must be children of
SwapperView. Note: You can programmatically add more children intoSwapperView. It's just aViewGroup.
- Swap to views:
class MainActivity: AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
setupViews()
}
private fun setupViews() {
// Make sure to set the first swapping view:
swapper_view.swapTo(first_view)
// Note: the first time you call swapTo() there will *not* be an animation.
// ... do stuff ....
// Anytime you want to swap to another View:
swapper_view.swapTo(second_view) {
// optional callback when animation is done.
}
}
}- Set the default animation duration used for all instances of
SwapperView:
// Value is in milliseconds
SwapperView.config.animationDuration = 100- Or, you can override the default for each instance of
SwapperView:
swapper_view_instance.animationDuration = 500- Set the default animation lambda used for all instances of
SwapperView:
SwapperView.config.swapAnimator = { oldView, newView, duration, onComplete ->
// Start animations here. When the animations are done running, call `onComplete()`
}- Or, you can override the default for each instance of
SwapperView:
swapper_view_instance.swapAnimator = { oldView, newView, duration, onComplete ->
// Start animations here. When the animations are done running, call `onComplete()`
}Swapper comes with an example app you can use to play with the library. To run the example project, clone the repo and then open it up in Android Studio.
- Install git hooks:
./hooks/autohook.sh install - Open up Swapper project in Android Studio.
- Get to writing code!
Thanks goes to these wonderful people (emoji key)
 Levi Bostian 💻 📖 🚧 |
Want to add features to Swapper? Before you decide to take a bunch of time and add functionality to the library, please, create an issue stating what you wish to add. This might save you some time in case your purpose does not fit well in the use cases of Swapper.
Swapper is available under the MIT license. See the LICENSE file for more info.