README.md · CHINASOFT_OHOS/loadinglayout

# loadinglayout

#### 项目介绍
- 项目名称：loadinglayout
- 所属系列：openharmony第三方组件适配移植
- 功能：简单实用的页面多状态布局(content,loading,empty,error)
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 beta1
- 基线版本：Release v1.0.1

#### 效果演示
![screenshot](img/screenshot1.gif)

#### 安装教程

在moudle级别下的build.gradle文件中添加依赖
 ```
// 添加maven仓库
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/releases/'
    }
}

// 添加依赖库
dependencies {
    implementation 'com.gitee.chinasoft_ohos:loadinglayout:1.0.0'
}
```

在sdk6，DevEco Studio2.2 beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明
 
简单实用的页面多状态布局(content,loading,empty,error)
 
- 用法一：在布局中使用，注意调用java方法nInactive()兼容

``` xml  
    <ezy.ui.layout.LoadingLayout
        ohos:id="$+id:loading"
        ohos:height="match_parent"
        ohos:width="match_parent"
        app:llEmptyText="暂无数据"
        app:llTextSize="16fp"
        app:llErrorImage="$media:error">
        <Text
            ohos:width="match_content"
            ohos:height="match_content"
            ohos:layout_alignment="center"
            ohos:text="This is Content"
            ohos:text_color="#cccccc"
            ohos:text_size="16fp"/>
    </ezy.ui.layout.LoadingLayout>
```
- 用法一：要调用该方法兼容下bug
``` java
    @Override
    public void onInactive() {
        super.onActive();
        // 兼容第二次进入之后相关页面不显示bug
        if (mLoadingLayout.getmLayouts() == null) {
            return;
        } else {
            mLoadingLayout.getmLayouts().clear();
        }

}
```

- 用法二：包裹并替换内容元素
``` java
 @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_other);
        mLoadingLayout = (LoadingLayout) findComponentById(ResourceTable.Id_loading);

// 调用类库公有方法，重新构建vLoading内容页面，特殊需求可将LoadingLayout类复制粘贴到项目，自行修改相关样式
        if (mLoadingLayout == null) {
            return;
        }

mLoadingLayout.onFinishInflate();
        mLoadingLayout.setRetryListener(new LoadingLayout.ClickedListenered() {
            @Override
            public void clicked(Component component) {

new ToastsUtils.Builder(getContext())
                    .setToastText(
                        // "测试other" +
                        "retry")
                    .build().show();
            }
        });
        mLoadingLayout.showContent();
    }
``` 
- API

``` java
// 显示 content/loading/empty/error 布局
showContent()
showLoading()
showEmpty()
showError()

// 设置 loading/empty/error 布局
setLoading(int resId)
setEmpty(int resId)
setError(int resId)

// 设置空布局的图片与文本
setEmptyImage(int resId)
setEmptyText(String value)

// 设置错误布局的图片与文本，
setErrorImage(int resId)
setErrorText(String value)

// 设置重试按钮文本
setRetryText(String value)

// 设置重试按钮的监听回调
setRetryListener(ClickedListenered listener)

```

- 属性配置的字段并获取的方法，参考AttrUtil

``` xml

mEmptyResId = AttrUtil.getResourceId(attrSet, "llEmptyResId", ResourceTable.Layout__loading_layout_empty);

mLoadingResId = AttrUtil.getResourceId(attrSet, "llLoadingResId", ResourceTable.Layout__loading_layout_loading);

mErrorResId = AttrUtil.getResourceId(attrSet, "llErrorResId", ResourceTable.Layout__loading_layout_error);

mEmptyImage = AttrUtil.getMediaId(attrSet, "llEmptyImage", ResourceTable.Media_empty);

mEmptyText = AttrUtil.getStringValue(attrSet, "llEmptyText", "暂无数据");

mErrorImage = AttrUtil.getMediaId(attrSet, "llErrorImage", ResourceTable.Media_icon);

mErrorText = AttrUtil.getStringValue(attrSet, "llErrorText", "无网络连接，请检查您的网络...");

mRetryText = AttrUtil.getStringValue(attrSet, "llRetryText", "加载失败，点击重试～～");

mTextColor = AttrUtil.getColorValue(attrSet, "llTextColor", COLOR);

mTextSize = AttrUtil.getDimension(attrSet, "llTextSize", AttrHelper.vp2px(ONESIX, getContext()));

mButtonTextColor = AttrUtil.getColorValue(attrSet, "llButtonTextColor", COLOR);

mButtonTextSize = AttrUtil.getDimension(attrSet, "llButtonTextSize", AttrHelper.vp2px(ONESIX, getContext()));

mButtonBackground = AttrUtil.getElementValue(attrSet, "llButtonBackground", background);

```

#### 测试信息
CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

#### 版本迭代
- 1.0.0

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

CHINASOFT_OHOS/loadinglayout

简介

发行版

贡献者

近期动态

CHINASOFT_OHOS/loadinglayout .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

CHINASOFT_OHOS/loadinglayout