LoadingButton

Introduction: A small and flexible button control with loading (一个小巧灵活的带加载功能的按钮控件)
More: Author   ReportBugs   
Tags:
0.50-

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

下载.png

Demo screenshot

1.gif 2.gif 3.gif 4.gif

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

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools