Skip to content

zlkevinet/SnackLoading

Repository files navigation

SnakeLoading

引入方式

repositories {
    maven {
        url  "https://entropy.bintray.com/library"
    }
}

dependencies {
    implementation 'com.entropy.lu:snack-loading:1.0.0'
}

功能支持

  1. 支持单页面显示多个loading
  2. 支持loading样式自定义
  3. 类似SnackBar自动绑定位置
  4. 支持非阻塞和阻塞操作
  5. 支持Lottie动画库

使用限制

  1. Loading相对于Fallback的显示位置只支持Gravity.Top和Gravity.Bottom两种配置
  2. Lottie Loading存在Path的不同比例缩放问题(后续可能需要对loading资源进行更换)
  3. 挂靠View的父类只能是FrameLayout、ConstraintLayout、RelativeLayout

版本历史

v1.0.0
  • 定义Loading的基础业务接入层
  • 定义ILoadingable的抽象接口层,提供业务层调用
  • 从ILoadingable接口分离出ILoadingHolder
  • 支持Loading的位置设置,目前只支持Gravity.Top和Gravity.Bottom两种配置
  • 支持单页面显示多个loading
  • 支持loading样式自定义
  • 支持挂靠式自动绑定位置
  • 支持非阻塞和阻塞操作
  • 支持Lottie动画库
  • 支持LifeCycle生命周期控制

Loading类型

  • Animation (默认\推荐)
  • ProgressBar
  • Lottie

使用方式

全局配置
Bundle renderParams = new Bundle();
renderParams.putInt(XXXXRender.kXXXResourceId, R.drawable.XXX);
LoadingUtil.configRender(LoadingRenderType.ANIMATION, XXXRender.class, renderParams);
LoadingConfig管理
LoadingConfig newConfig = LoadingConfig.create()
                                    .setRenderType(LoadingRenderType.Animation)
                                    .setLoadingGravity(Gravity.Bottom)
                                    .setWithMaskLayer(true)
                                    .setMaskBackgroundColor(0x4c00ff00)
                                    .setRenderParams(bundle)
                                    .setStartDelay(300)
                                    .build();
显示Loading
//显示默认类型的Loading
Loading.make(context, fallbackView).show()

//显示ANIMATION类型的Loading
Loading.make(context, LoadingRenderType.ANIMATION, fallbackView).show()

or
//显示ANIMATION类型、带有更新参数的Loading
Loading.make(context, LoadingRenderType.ANIMATION, params, fallbackView).show()

or
//显示ANIMATION类型、带有更新参数、带有阻塞式蒙层的Loading
Loading.make(context, LoadingRenderType.ANIMATION, params, fallbackView, true).show()

or
//显示ANIMATION类型、带有更新参数、带有阻塞式蒙层、位置设置的Loading
Loading.make(context, LoadingRenderType.ANIMATION, params, fallbackView, true, Gravity.Bottom).show()

or
//显示指定LoadingConfig的Loading
Loading.make(context, fallbackView, loadingConfig).show()
隐藏Loading
//隐藏指定View的Loading
Loading.hide(fallbackView)

or
//隐藏所有Loading
Loading.hide()
Demo样例
1. 直接使用
class MainActivity extends AppCompatActivity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        View fallbackView = findViewById(R.id.loading);
        Loading.make(this, fallbackView).show()
    }

    @Override
    public void onDestroy() {
        super.onDestroy()
        Loading.hide()
    }
}
2. 集成业务接入层
//Activity
class MainActivity extends AbsLoadingActivity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        View fallbackView = findViewById(R.id.loading);
        showLoading();
    }

    @Override
    public void onDestroy() {
        super.onDestroy()
        hideLoading();
    }

    @Override
    public View getFallbackView() {
        return findViewById(R.id.loading);
    }
}

//Fragment
class DemoFragment extends AbsLoadingFragment {
    public void loadData() {
        showLoading();
        Cloud.requestData(new RemoteCallback(){
            void onFinish(){
                hideLoading()
            }
        });
    }

    @Override
    public View getFallbackView() {
        return findViewById(R.id.loading);
    }
}

//View or Business
class DataView extends AbsLoadingView {

    public void loadData() {
        showLoading();
        Cloud.requestData(new RemoteCallback(){
            void onFinish(){
                hideLoading()
            }
        });
    }

    @Override
    public View getFallbackView() {
        return mContentLayout;
    }
}

自定义Loading

实现自定义ProgressBar Loading
实现自定义Animation Loading
实现自定义Lottie Loading

后续计划

  1. 增加margin和padding参数 ->1.0.2
  2. 缓存相同的Loading显示展示过程,避免每次对ViewTree进行刷新 ->1.0.2
  3. 阻塞式Loading跟随Fallback变化 ->1.0.4
  4. 整体提取公共Render参数 ->1.0.6
  5. 优化重构Render资源和结构 ->1.0.8
  6. 支持进度控制动画 ->1.1.0