Awesome

KTLoadingButton

Simple loading button for kotlin android apps. This button can show results in a nicely designed way to not block the ui while the user is waiting.

<br/>

<br/> <br/><br/>

SUCCESS	ERROR	PROGRESS

• You can set a validation function if the button should show the loading animation (e.g. if a text field is not filled correctly):

test_button.validation = { // call a function for validation }

Installation

1. Add the JitPack repository to your build file

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

2. Add the dependency

dependencies {
		implementation 'com.github.timonknispel:KTLoadingButton:XXXX'
	}

Where XXXX need to be replaced by the version showen in the badge above.

Usage

Example needed? Look inside the app folder

1. Add the KTLoadingButton to your layout

<de.timonknispel.ktloadingbutton.KTLoadingButton  
  android:id="@+id/test_button"  
  android:layout_width="wrap_content"  
  android:layout_height="wrap_content"  
  app:buttonName="Test"  
 />

2. DONE Now all you have to do is to start the button. This can be done in several ways.

Option 1: INTERMEDIATE (DEFAULT)

Automatically by setting a onClickListener :

test_button.setOnClickListener {}

Simply call :

test_button.startLoading()

This will start the loading animation of the button. By default it should now intermediate.

When loading is done simply call:

test_button.doResult(success: Boolean)

This will stop the loading animation and start the result animation according to the given success. Optional you can add a callback if you want to know when the animation is done. It also returns the LoadingButton itself:

test_button.doResult(success: Boolean) { it: KTLoadingButton -> 
// do stuff here
}

Option 2: PROGRESS

Add the progressStyle option to your xml layout:

<de.timonknispel.ktloadingbutton.KTLoadingButton  
  android:id="@+id/test_button"  
  android:layout_width="wrap_content"  
  android:layout_height="wrap_content"  
  app:buttonName="Test"  
  app:progressStyle="PROGRESS"  
  />

All you have to do now is to call:

test_button.setProgress(progress: Float)

to show the progress.

Good to know

• You can add a callback to the button if you need the click event even if the button is in loading state. The return type decides if the click event should be passed to the LoadingButton:

test_button.touchListener = {
// do some stuff
return [true|false]
}

This can be handy if for example want the user to cancel the loading process.

• You can reset the button by calling:

test_button.reset()

• You can set a validation function if the button should show the loading animation (e.g. if a text field is not filled correctly):

test_button.validation = { // call a function for validation }

Customization

In XML