RuleView

该三方开源库从github fork过来

fork地址：https://github.com/zjun615/RulerView

fork版本号/日期：0.9.9 / 2021/1/28

RuleView

一系列卷尺控件，包含：基本卷尺控件（体重尺，或其它）、金额卷尺控件、时间卷尺控件

demo中，分别用三个控件，高仿了薄荷健康的体重尺、团贷网的金额尺、海康威视下萤石云视频的时间尺

添加依赖：

方式一：添加har包到lib文件夹内在entry的gradle内添加如下代码 implementation fileTree(dir: 'libs', include: ['.jar', '.har'])

方式二： allprojects { repositories{ mavenCentral() } }

implementation 'io.openharmony.tpc.thirdlib:RuleView:1.0.0'

二、卷尺功能说明

1. RuleView

基本卷尺控件，主要功能：

手动滑动
惯性滑动
停止后，自动定位到最近的刻度
支持动态修改最小值、最大值、当前值

demo中以体重尺为例，但不限于此

2. MoneySelectRuleView

金额选择尺，除了基本卷尺的功能外，额外的功能有：

可设置“剩余金额”

3. TimeRuleView

时间尺，一天24h内的时间尺，最小刻度是1s

支持惯性滑动
支持缩放时间刻度
支持多个时间段的显示

三、依赖

引用本地lib compile project(path: ':rule_view')

四、使用

4.1 布局

都是最简单的使用，根据需要使用自定义属性即可，详细的自定义属性见五

<com.zjun.widget.RuleView
           ohos:id="$+id:gv_1"
           ohos:width="match_parent"
           ohos:height="70vp"
           ohos:padding="50vp"
           app:zjun_indicatorLineColor = "#ff0000"
   />

   <com.zjun.widget.MoneySelectRuleView
               ohos:id="$+id:msrv_money"
               ohos:width="match_parent"
               ohos:height="match_content"/>

                <com.zjun.widget.TimeRuleView
                           ohos:id="$+id:trv_time"
                           ohos:width="match_parent"
                           ohos:height="match_content"/>

### 4.2 监听回调

主要用来监听当前数值的变化
```java
ruleView.setOnValueChangedListener(new RuleView.OnValueChangedListener() {
   @Override
   public void onValueChanged(float value) {
       tvValue.setText(Float.toString(value));
   }
});
 
// 金额的超额判断，不在自定义View中判断，使用时自行判断，可参考demo
moneySelectRuleView.setOnValueChangedListener(new MoneySelectRuleView.OnValueChangedListener() {
   @Override
   public void onValueChanged(int newValue) {
       tvMoney.setText(Integer.toString(newValue));
   }
});
 
timeRuleView.setOnTimeChangedListener(new TimeRuleView.OnTimeChangedListener() {
   @Override
   public void onTimeChanged(int newTimeValue) {
       tvTime.setText(TimeRuleView.formatTimeHHmmss(newTimeValue));
   }
});

五、属性说明

5.1 RuleView属性

属性名	说明	默认值
zjun_bgColor	背景颜色	#f5f8f5
zjun_gradationColor	刻度颜色	Color.LTGRAY(#CCCCCC)
gv_shortLineWidth	短刻度线的宽度	1dp
gv_shortGradationLen	短刻度长度	16dp
gv_longGradationLen	长刻度长度	gv_shortGradationLen * 2
gv_longLineWidth	长刻度线的宽度	gv_shortLineWidth * 2
zjun_textColor	刻度值字体颜色	Color.BLACK，#000000
zjun_textSize	刻度值字体大小	14sp
zjun_indicatorLineColor	中间指针线的颜色	#48b975
zjun_indicatorLineWidth	中间指针线的宽度	3dp
gv_indicatorLineLen	中间指针线的长度	35dp
gv_minValue	最小值	0f
gv_maxValue	最大值	100f
gv_currentValue	当前值	50f
gv_gradationUnit	刻度间最小单位数值	.1f
gv_numberPerCount	两数值间最小单位的个数	10
gv_gradationGap	最小单位的间距	10dp
gv_gradationNumberGap	数值与最长刻度的间距	8dp

5.2 MoneySelectRuleView属性

属性名	说明	默认值
zjun_bgColor	背景色	#F5F5F5
zjun_gradationColor	刻度颜色	Color.LTGRAY(#CCCCCC)
msrv_gradationHeight	刻度的总高度，刻度基线以上的高度	40dp
msrv_gradationShortLen	短刻度的长度	6dp
msrv_gradationLongLen	长刻度的长度	msrv_gradationShortLen * 2
msrv_gradationShortWidth	短刻度的宽度	1px
msrv_gradationLongWidth	短刻度的长度	msrv_gradationShortWidth
msrv_gradationValueGap	刻度数值与长刻度的间距	8dp
msrv_gradationTextSize	刻度数值文字的大小	12sp
zjun_textColor	刻度数值文字的颜色	Color.GRAY
zjun_indicatorLineColor	中间指针线的颜色	#eb4c1c
msrv_balanceTextSize	余额文字的大小	10sp
msrv_unitGap	最小单位的间距	6dp
msrv_balanceText	余额文字内容	"剩余额度"
msrv_balanceGap	余额文字与刻度基线的间距	4dp
msrv_maxValue	最大金额	50_000
msrv_currentValue	当前金额	0
msrv_balanceValue	剩余金额	0
msrv_valueUnit	每隔最小单位代表的金额值	100
msrv_valuePerCount	刻度数值间的最小单位数	10

5.3 TimeRuleView属性

属性名	说明	默认值
zjun_bgColor	背景颜色	#EEEEEE
zjun_gradationColor	刻度颜色	Color.GRAY
trv_partHeight	时间段的高度	20dp
trv_partColor	时间的颜色	#F58D24
trv_gradationWidth	刻度的宽度	1px
trv_secondLen	秒刻度的长度	3dp
trv_minuteLen	分刻度的长度	5dp
trv_hourLen	时刻度的长度	10dp
trv_gradationTextColor	刻度数值颜色	Color.GRAY
trv_gradationTextSize	刻度数值字体大小	12sp
trv_gradationTextGap	刻度数值与时刻度的间距	2dp
trv_currentTime	当前时间	0（单位：秒，范围∈[0, 24*3600]）
trv_indicatorTriangleSideLen	中间指针头部三角形的边长	15dp
zjun_indicatorLineWidth	中间指针的宽度	1dp
zjun_indicatorLineColor	中间指针的颜色	Color.RED

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.

HarmonyOS-TPC / RulerView

RuleView

二、卷尺功能说明

1. RuleView

2. MoneySelectRuleView

3. TimeRuleView

三、依赖

四、使用

4.1 布局

五、属性说明

5.1 RuleView属性

5.2 MoneySelectRuleView属性

5.3 TimeRuleView属性

简介

发行版

贡献者

近期动态

HarmonyOS-TPC / RulerView .gitee-modal { width: 500px !important; }

RuleView

二、卷尺功能说明

1. RuleView

2. MoneySelectRuleView

3. TimeRuleView

三、依赖

四、使用

4.1 布局

五、属性说明

5.1 RuleView属性

5.2 MoneySelectRuleView属性

5.3 TimeRuleView属性

简介

发行版

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

贡献者

近期动态

搜索帮助

HarmonyOS-TPC / RulerView