LoadingButton

A small and flexible button control with loading function,Extends from DrawableTextView，Loading animation comes from CircularProgressDrawable

Feature

• Support button shrink
• Support loading completion and failure icon
• Can custom loading drawable color, size, position and loading button shape
• Custom radius

How to install 中文说明

root directory build.gradle

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

App module build.gradle

 	dependencies {
		//Androidx
		implementation 'com.github.FlodCoding:LoadingButton:1.1.0-alpha01'
		
	}

Support-appcompat stop update
implementation 'com.github.FlodCoding:LoadingButton:1.0.5-support'

Demo Click me to download the apk

Demo screenshot

Basic usage

XML

 <com.flod.loadingbutton.LoadingButton
            android:id="@+id/loadingBtn"
            android:layout_width="match_parent"
            android:layout_height="50dp"
            android:layout_gravity="center_horizontal"
            android:background="@android:color/holo_red_light"
            android:drawablePadding="10dp"
            android:gravity="center"
            android:minHeight="45dp"
            android:padding="8dp"
            android:text="Submit"
            android:textColor="@android:color/white"
            android:textSize="14sp"
            app:endSuccessDrawable="@drawable/ic_successful"
            app:endFailDrawable="@drawable/ic_fail"
            app:radius="50dp"
            app:enableShrink="true"
	        app:enableRestore="true"
            app:shrinkShape="Oval"
            app:loadingDrawablePosition="Start" />

Code

loadingBtn.start();              //Start loading
loadingBtn.complete(true);       //Success
loadingBtn.complete(false);      //failed
loadingBtn.cancel();             //Cancel loading  

loadingBtn.setEnableShrink(true)
	      .setEnableRestore(true)
          .setDisableClickOnLoading(true)
          .setShrinkDuration(450)
          .setLoadingPosition(DrawableTextView.POSITION.START) 
          .setSuccessDrawable(R.drawable.ic_successful)
          .setFailDrawable(R.drawable.ic_fail)
          .setEndDrawableKeepDuration(900)
          .setLoadingEndDrawableSize((int) (loadingBtn.getTextSize() * 2));

loadingBtn.getLoadingDrawable().setStrokeWidth(loadingBtn.getTextSize() * 0.14f);
loadingBtn.getLoadingDrawable().setColorSchemeColors(loadingBtn.getTextColors().getDefaultColor());
           

State callback

start --> onShrinking --> onLoadingStart
complete --> onLoadingStop --> onEndDrawableAppear --> onCompleted --> onRestored

    public static class OnStatusChangedListener {

        public void onShrinking() {}

        public void onLoadingStart() {}

        public void onLoadingStop() {}

        public void onEndDrawableAppear(boolean isSuccess, EndDrawable endDrawable) {}

        public void onRestoring() {}

        public void onRestored() {}
	
        public void onCompleted(boolean isSuccess) { }

        public void onCanceled() {}
    }

Attribute

XML

Attribute name	type	Default value	Description
enableShrink	boolean	true	Shrink when begin loading
disableClickOnLoading	boolean	true	Disable click on loading
enableRestore	boolean	false	When finished, restore button(shape and text)
radius	dimension	0dp	Set the rounded corners of the button,(need SDK>=21) (from(DrawableTextView)
shrinkDuration	integer	450ms	Shrink animation duration
shrinkShape	enum (Default,Oval)	Oval	Shape after shrinking (need SDK>=21) (Default:Keep the original shape,Oval:Round shape)
loadingEndDrawableSize	dimension	TextSize *2	Set the size of LoadingDrawable and EndDrawable
loadingDrawableColor	reference	TextColor	Set loading color
loadingDrawablePosition	enum (Start,Top, End,Bottom)	Start	Set the loading drawable position
endSuccessDrawable	reference	null	Successful drawable
endFailDrawable	reference	null	failed drawable
endDrawableAppearTime	integer	300ms	Time for completion or failure icon to emerge from nothing
endDrawableDuration	integer	900ms	endDrawable keeping time

Public Func

Method name	Parameter description	default value	Description
start()	-	-	Start loading
complete(boolean isSuccess)	whether succeed	-	Complete loading
cancel() cancel(boolean withRestoreAnim)	Whether to perform restore animation	true	Cancel loading
setEnableShrink(boolean enable)	-	true	Shrink when begin loading
setEnableRestore(boolean enable)	-	false	When finished, restore button(shape and text)
setRadius(@Px int px) setRadiusDP(int dp)	Px/Dp	0	Set the rounded corners of the button,(need SDK>=21) (from(DrawableTextView)
setShrinkShape(@ShrinkShape int shrinkShape)	Default:Keep the original shape,Oval:Round shape	Oval	Shape after shrinking (need SDK>=21)
setShrinkDuration(long time)	milliseconds	450ms	Shrink animation duration
setLoadingEndDrawableSize(@Px int px)	Px	TextSize *2	Set the size of LoadingDrawable and EndDrawable
setLoadingPosition(@POSITION int position)	Start,Top,End,Bottom	Start	Set the loading drawable position
setSuccessDrawable(@DrawableRes int drawableRes) setSuccessDrawable(Drawable drawable)	-	null	Successful drawable
setFailDrawable(@DrawableRes int drawableRes) setFailDrawable(Drawable drawable)	-	null	failed drawable
setEndDrawableAppearDuration(long time)	milliseconds	300ms	Time for completion or failure icon to emerge from nothing
setEndDrawableKeepDuration(long time)	milliseconds	900ms	endDrawable keeping time
setOnStatusChangedListener (OnStatusChangedListener listener)	-	null	State callbacks of buttons

Third-party libraries used by Demo

Matisse

Glide