# RopeProgressBar

**Repository Path**: chinasoft5_ohos/RopeProgressBar

## Basic Information

- **Project Name**: RopeProgressBar
- **Description**: 进度条在自身重量下”弯曲“
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2021-06-10
- **Last Updated**: 2022-09-06

## Categories & Tags

**Categories**: harmonyos-progress

**Tags**: None

## README

# RopeProgressBar

#### 项目介绍
- 项目名称：RopeProgressBar
- 所属系列：openharmony的第三方组件适配移植
- 功能：进度条在自身重量下”弯曲“
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6,DevEco Studio2.2 Beta1
- 基线版本：Release v0.1.2

#### 效果演示

![效果演示](printscreen/ropeprogressbar.gif)

#### 安装教程

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:RopeProgressBar:1.0.0')
    ......  
 }
 ```

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

#### 使用说明

---
自定义属性

| 属性                      | 类型       | 默认值                        | 作用                                                         |
| ------------------------ | --------- | ----------------------------- | ------------------------------------------------------------ |
| `app:ropeMax`            | integer   | 0                             | 进度条的最大值                                                 |
| `app:ropeProgress`       | integer   | 0                             | 进度条的当前值                                                 |
| `app:ropePrimaryColor`   | color     | 0xFF009688                    | 用于完成进度的颜色                                              |
| `app:ropeSecondaryColor` | color     | 0xFFDADADA                    | 用于剩余进度的颜色                                              |
| `app:ropeSlack`          | dimension | 32vp                          | 进度条的最大垂直弯曲                                            |
| `app:ropeStrokeWidth`    | dimension | 8vp                           | 进度条线的宽度                                                 |
| `app:ropeDynamicLayout`  | boolean   | false                         | 进度条的高度随松弛度的变化而变化                                  |

---
1.要使用 RopeProgressBar，您需要使用 xml 文件或 Java 代码将其添加到布局中
```示例XML
  <com.deange.ropeprogressview.RopeProgressBar
            ohos:height="match_content"
            ohos:width="match_parent"
            app:ropeMax="$integer:progress_max"
            />
```
2.初始化控件
```java
    RopeProgressBar mRopeProgressBar = findRopeProgressView(decorView);
```
3.改变进度
```java
      @Override
      public void onProgressUpdated(final Slider seekBar, final int progress, final boolean user) {
          //拖动进度改变回调时调用
          mRopeProgressBar.setProgress(progress);
      }
  
      @Override
      public void onTouchStart(final Slider seekBar) {
          //拖动开始调用
          mRopeProgressBar.defer();
      }
  
      @Override
      public void onTouchEnd(final Slider seekBar) {
          //拖动结束调用
          mRopeProgressBar.endDefer();
      }
  
      @Override
      public void onClick(final Component component) {
          final int progress = Integer.parseInt(mEditText.getText());
          //点击改变进度
          mRopeProgressBar.animateProgress(progress);
      }
```
4.点击进度条改变进度
#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

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

#### 版本迭代
- 1.0.0
- 0.0.1-SNAPSHOT

#### 版权和许可信息

```
Copyright 2017 Christian De Angelis

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.
```