yiyeshua / LoadingViewGroup

扁平化的loading展示方案，可单独使用，也可以作为根容器使用

LoadingViewGroup ：加载容器view

扁平化的loading展示方案，可单独使用，也可以作为根容器使用

一、已支持功能：

• 骨架图，loading，loadingFail 展示
• view级别动画拓展与事件处理
• 单独loading自由摆放、作为根容器

二、使用：

发布在coding 制品仓库

2.1 依赖：

implementation("com.foundation.widget:loadingview:版本号")

2.2 简单使用：

单独使用

                <com.foundation.widget.loading.PageLoadingView
                    android:layout_gravity="center"
                    android:id="@+id/normalLoading"
                    android:visibility="gone"
                    android:layout_width="match_parent"
                    android:layout_height="match_parent" />

作为根容器

        <com.foundation.widget.loading.LoadingConstraintLayout
            android:id="@+id/contentLoading"
            android:layout_width="wrap_content"
            android:layout_height="match_parent">
            childView....
            </com.foundation.widget.loading.LoadingConstraintLayout>

主动关闭在xml的预览效果

 app:closeEffect="true"

状态切换

            PageLoadingView.showLoading()
            PageLoadingView.showLoadingFail(false,0,"extra")
            PageLoadingView.stop()

2.3 自定义

• 2.3.1 定义适配器

/**
 * 自定义loading逻辑
 */
class MyContentLoadingAdapter(private val context: Context) : PageLoadingAdapter {

    /**
     * 设置骨架图
     */
    override fun getBottomPlateView(): View = AppCompatImageView(context).apply {
        layoutParams = ViewGroup.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        )
        background = ContextCompat.getDrawable(context, R.drawable.img_skeleton_screen)
    }

    /**
     * 自定义加载动画的View
     */
    private val loadingView = AppCompatImageView(context).apply {
        background = ContextCompat.getDrawable(context, R.drawable.dw_loading)
    }

    override fun getLoadingView(): View? = loadingView

    /**
     * 展示动画
     */
    override fun onShowLoading(loadingView: View) {
        if (loadingView.background is Animatable) {
            val anim = loadingView.background as Animatable
            anim.start()
        }
    }

    /**
     * 设置失败展示
     */
    override fun getLoadingFailView(): View? = LayoutInflater
        .from(context)
        .inflate(R.layout.fail, null).apply {
            layoutParams = ViewGroup.LayoutParams(
                ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT
            )
        }

    /**
     * 设置失败响应事件
     */
    override fun onShowFail(
        failView: View,
        type: Int,
        extra: Any?,
        failViewEvent: (view: View, type: Int, extra: Any?) -> Unit
    ) {
        failView.findViewById<View>(R.id.btn).setOnClickListener {
            failViewEvent.invoke(failView, type, extra)
        }
    }

    /**
     * 停止动画
     */
    override fun onStop(loadingView: View?, failView: View?) {
        if (loadingView?.background is Animatable) {
            val anim = loadingView.background as Animatable
            anim.stop()
        }
    }

}

• 2.3.2 设置适配器

PageLoadingView.setLoadingAdapter(MyContentLoadingAdapter(this))

三、特殊说明 完整适配器接口：PageLoadingAdapter

/**
 * loading 适配器
 * 除了提供属性拓展，也提供了生命周期回调，用于状态初始化与资源释放
 * loadingView,failView,bottomPlateView,内置的 LayoutParams 都是wrap_content的
 * 如果其中一个使用了match_parent时，根布局最好是match_parent，或者固定尺寸
 * 他们都将影响根布局的测量，如同在xml设置属性一致。
 * create by zhusw on 5/7/21 09:37
 */
interface PageLoadingAdapter {
    fun getBottomPlateView(): View?
    fun getLoadingView(): View?
    fun getLoadingFailView(): View?
    fun getEmptyView(): View?

    fun onShowLoading(loadingView: View)

    /**
     * @param failView
     * @param type 展示失败view时的类型
     * @param extra  展示失败view时的额外参数
     * @param failViewEvent 事件响应
     */
    fun onShowFail(
        failView: View,
        type: Int = 0,
        extra: Any?,
        failViewEvent: (view: View, type: Int, extra: Any?) -> Unit
    )

    fun onShowEmptyView(emptyView: View)

    /**
     * 为什么是可空类型：loading 与 fail 是完全隔离的状态，不会同时出现
     * 但他们却存在交替出现的可能，可以交替出现多次，但最终只需要停止一次
     */
    fun onStop(loadingView: View?, failView: View?)


}