# Zloading

**Repository Path**: chinasoft_ohos/Zloading

## Basic Information

- **Project Name**: Zloading
- **Description**: 一款自定义的炫酷的加载动画类库
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2021-05-28
- **Last Updated**: 2024-08-07

## Categories & Tags

**Categories**: harmonyos-animate

**Tags**: None

## README

# Zloading

#### 项目介绍
- 项目名称：Zloading加载动画库
- 所属系列：openharmony的第三方组件适配移植
- 功能：这是一个自定义控件合集,目前包含主要包含加载动画的view
- 项目移植状态：主功能完成
- 调用差异：无
- 基线版本: master分支
- 开发版本：sdk6，DevEco Studio2.2 Beta1

#### 效果演示

<img src="gif/scren.gif"></img>

#### 安装教程

1.在项目根目录下的build.gradle文件中，
 ```
 allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
 }
```
2.在entry模块的build.gradle文件中，
 ```
 dependencies {
    implementation('com.gitee.chinasoft_ohos:Zloading:1.0.2')
    ......  
 }
```

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

#### 使用说明

组件主要是继承DependentLayout实现的Text标签动态操作类，都包含标签的动态添加，删除，监听等操作

XML中添加控件:

```xml
<com.zyao89.view.zloading.ZLoadingView
                    ohos:id="$+id:loadingView_1"
                    ohos:width="match_content"
                    ohos:height="match_content"
                    ohos:foreground_alignment="center"
                    app:z_color="#ff00ddff"
                    app:z_type="0"
                    app:z_duration_percent="0.5"/>
```

文本标签初始化数据，添加监听事件操作:

```java
  // 获取配置文件中组件
  ZLoadingView mzLoadingViewTopLeft = (ZLoadingView) findComponentById(ResourceTable.Id_loadingView_1);
  // 设置相应监听
  mzLoadingViewTopLeft.setBindStateChangedListener(mzLoadingViewTopLeft);
  // 设置type生成相应的加载视图
  mzLoadingViewTopLeft.setLoadingBuilder(Z_TYPE.values()[typeParam]);
```

自定义MaterialSpinner控件，可以添加自定义属性，具体可用属性如下:

| name                    | type      | info                                                   |
|-------------------------|-----------|--------------------------------------------------------|
| z_color                 | int       | 设置view的颜色                                         |
| z_type                  | int       | 设置view类型，生成对应类型的加载动画                   |
| z_duration_percent      | int       | 设置动画间隔时间                                       |

#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

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

#### 版本迭代

- 1.0.2

#### 版权和许可信息

 Copyright 2017 zyao89

   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.