80

GitHub - totond/BooheeRuler: 仿写薄荷健康体重选择控件——Hencoder「仿写酷界面」活...

 6 years ago
source link: https://github.com/totond/BooheeRuler
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

BooheeRuler

　　这是仿写薄荷健康里面体重选择尺的控件，因为最新的0.1.x版本经历重大更新（重构，把尺子分成多种形式），所以重新写一个README来介绍（旧的README在这里）：

最初是为了参加HenCoder的活动，最后也获奖了，谢谢HenCoder凯哥！

　　由于不少伙伴们发邮件或者issue让我做纵向的尺子，其实我也很想做，但是最近项目有点忙，最后就只能在不太忙的阶段偷偷把它做出来了，欢迎大家使用，多多指教小弟哈。 　　这次更新主要是把InnerRuler里面的一些公共的逻辑提取出来，做成抽象类，然后再由两个HorizontalRuler和VerticalRuler继承它，再实现一些公共逻辑的处理，最后实现四个类型的子类：LeftHeadRuler、TopHeadRuler、RightHeadRuler、BottomHeadRuler。**这样能大大减少重复的代码，缺点就是逻辑分开了，想通过代码看实现一个尺子的逻辑就要跳来跳去有点不方便。具体的重构思路在这

要是想参考下一个完整的尺子的实现逻辑，可以看上一个版本0.0.7的代码，直接在Gradle里面： compile 'com.yanzhikai:BooheeRuler:0.0.7'就可以了。 　　

Gradle

    compile 'com.yanzhikai:BooheeRuler:0.1.6'

　　Demo里面有4个尺子，这里就写一个，因为都是差不多的。BooheeRuler分成两个部分，一个是上面的显示多少kg的数字Layout，还有一个就是下面的尺子。首先在xml文件里调用（下面属性的作用可以看后面的表格）：

        <!--数字和单位-->
        <yanzhikai.ruler.KgNumberLayout
            android:id="@+id/knl_bottom_head"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:kgTextSize="20sp"
            app:scaleTextSize="50sp" />                          
                                                           
    <!--尺子-->
    <yanzhikai.ruler.BooheeRuler
        android:id="@+id/br_top_head"
        android:layout_width="match_parent"
        android:layout_height="100dp"
        android:layout_alignParentBottom="true"
        app:bigScaleLength="40dp"
        app:bigScaleWidth="2.5dp"
        app:count="10"
        app:currentScale="666"
        app:cursorDrawable="@drawable/cursor_shape"
        app:cursorHeight="45dp"
        app:cursorWidth="4dp"
        app:maxScale="2000"
        app:minScale="464"
        app:numberTextSize="22sp"
        app:paddingStartAndEnd="10dp"
        app:rulerStyle="TOP_HEAD"
        app:scaleInterval="11.5dp"
        app:smallScaleLength="20dp"
        app:smallScaleWidth="1.5dp"
        app:textMarginHead="80dp" />

　　然后在java代码里面使用：

public class MainActivity extends AppCompatActivity {
    private BooheeRuler br_top_head;
    private KgNumberLayout knl_top_head;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        br_top_head = (BooheeRuler) findViewById(R.id.br_top_head);
        knl_top_head = (KgNumberLayout) findViewById(R.id.knl_top_head);
        knl_top_head.bindRuler(br_top_head);

    }
}

BooheeRuler的使用环境是API >= 16

BooheeRuler的属性

属性名称 意义 类型 默认值
minScale 尺子的最小刻度值 integer 464,在尺子上显示就是 464 * factor46.4
maxScale 尺子的最大刻度值 integer 2000,在尺子上显示就是200 * factor 200.0
smallScaleLength 尺子小刻度（0.1）的刻度线长度 dimension 30px
smallScaleWidth 尺子小刻度（0.1）的刻度线宽度/粗细 dimension 3px
bigScaleLength 尺子大刻度（1.0）的刻度线长度 dimension 60px
bigScaleWidth 尺子大刻度（1.0）的刻度线宽度/粗细 dimension 5px
cursorHeight 尺子中间的选定光标的刻度图高度 dimension 70px
cursorWidth 尺子中间的选定光标的刻度图宽度 dimension 8px
textMarginTop textMarginHead 尺子数字文字距离边界距离 dimension 120px
numberTextSize 尺子数字文字大小 dimension 28px
scaleInterval 尺子每条刻度线之间的距离 dimension 18px
numberTextColor 尺子数字文字颜色 color #2B2E2B
scaleColor 尺子刻度线的颜色 color #e2e5e2
currentScale 尺子初始选定刻度 float (maxScale + minScale)/2
cursorDrawable 尺子中间选定光标的Drawable(会把drawable伸缩到设定的宽高上) dimension @drawable/cursor_shape
count 一个大刻度格子里面的小刻度格子数 integer 10
paddingStartAndEnd 控制尺子两端的padding dimension 0
canEdgeEffect (new) 是否启用边缘效果 boolean true
edgeColor (new) 边缘效果的颜色（API大于等于21设置才有效） color #4bbb74
rulerBackGround 尺子的背景 reference或者color #f6f9f6
factor（new） 乘积因子，尺子刻度值实际显示为：scale * factor float 0.1
rulerStyle 尺子的形态（下面有具体介绍） enum TOP_HEAD

　　接下来是选择尺子形态的属性rulerStyle：

rulerStyle选项 意义
TOP_HEAD 头部向上的尺子
BOTTOM_HEAD 头部向下的尺子
LEFT_HEAD 头部向左的尺子
RIGHT_HEAD 头部向右的尺子

如效果图中，对应位置的尺子的rulerStyle为：上——BOTTOM_HEAD，下——TOP_HEAD，左——RIGHT_HEAD，右——LEFT_HEAD。

　　使用setXX()方法改变一些尺子属性的时候，请调用refreshRuler()方法让尺子重新初始化，不然数值可能会错乱，出现一堆bug。除了setCurrentScale()，这个不用刷新，会直接执行跳转。

factor说明

　　相当于设置每个刻度的最小单位。如factor等于5时：

　　注意，回调中的scale值还是原来的currentScale，所以在KgNumberLayout里面做的处理改成：

    @Override
    public void onScaleChanging(float scale) {
        if (mRuler != null) {
            tv_scale.setText(RulerStringUtil.resultValueOf(scale, mRuler.getFactor()));
        }
    }

边缘效果说明

　　0.1.2版本新增的效果，在API大于等于21（Android5.0）的时候是这样的效果：

　　在API小于21（Android5.0）的时候是这样的效果：

KgNumberLayout属性

属性名称 意义 类型 默认值
scaleTextSize 数字字体大小 dimension 80
kgTextSize 单位字体大小 dimension 40
scaleTextColor 数字字体颜色 color #4bbb74
kgTextColor 单位字体颜色 color #4bbb74
kgUnitText 单位文字内容 string kg

　　除了使用KgNumberLayout作为显示BooheeRuler的当前刻度之外，还可以通过实现RulerCallback回调接口来获取当前选定刻度：

public interface RulerCallback {
    //选取刻度变化的时候回调
    //注意，scale值不一定是实际值，大概值是实际值/factor
    void onScaleChanging(float scale);
}

　　实现了这个接口之后，再调用BooheeRuler.setCallback(RulerCallback rulerCallback)方法传入即可。

PS:由于0.1.4更新了factor属性，所以推荐使用RulerStringUtil.resultValueOf(scale, mRuler.getFactor())方法来将scale属性转化为String，具体可以参考KgNumberLayout的源码。

  • 2017/10/23 version 0.0.5:
    • 修改了画刻度的方法，改为只画当前屏幕显示的刻度
    • 增加了count属性，用于设置一个大刻度格子里面的小刻度格子数，默认是10
  • 2017/10/30 version 0.0.6:
    • 加入VelocityTracker的回收处理（之前只是clear并没有recycle），提高性能。
    • 加入属性paddingStartAndEnd，用于控制尺子两端的padding。
    • 让刻度的绘制前后多半大格，这样可以提前显示出下面的数字，让过渡不会变得那么突兀。
    • 取消了一些不必要的log输出。

非常感谢JulianAndroid为我指出来VelocityTracker这个错误。

  • 2017/10/30 version 0.0.7:

    • 之前VelocityTracker重复使用了addMovement，现在取消掉了。

  • 2017/11/15 version 0.1.0:

    • 重构代码，将尺子分为4个形态。
    • 对细节有一些小改动：如背景设置换成以InnerRuler为主体，优化Padding等。

  • 2017/11/16 version 0.1.1:

    • 修复KgNumberLayout修改单位会出错的bug

  • 2017/11/28 version 0.1.2:

    • 修复触发ACTION_CANCEL事件会令刻度停在非整点地方的bug
    • 增加边缘效果

  • 2017/12/13 version 0.1.3:

    • 性能优化：BooheeRuler的onLayout之前没有利用change属性，导致每次刷新都会重新Layout，现在不会。
    • 性能优化：修改了画刻度的逻辑，现在在刻度范围很大的情况下还可以顺畅滑动。
    • 修复了goToScale()重复回调导致显示刻度不准确的问题。

非常感谢littlezan提出的性能优化建议。

  • 2017/12/25 version 0.1.4:
    • 功能增加：增加属性factor，乘积因子，可以调节刻度值具体最小单位，默认值是0.1。如currentScale是464时，显示出的值为464 * 0.1 = 46.4。增加了RulerStringUtil类来处理回调方法的scale值。
  • 2017/12/28 version 0.1.5:
    • 修复使用setXX()方法改变一些尺子属性的时候，会导致各种错乱的情况。措施：请使用完setXX()方法改变属性之后，调用refreshRuler()方法让尺子重新初始化。(除了setCurrentScale()，这个不用刷新，会直接执行跳转，之前忘记说了，以为就算刷新了也没什么问题，不好意思。。。)
  • 2019/1/1 version 0.1.6:
    • 没想到隔了一年才更新，可怕。修复了因为刻度转px值float转int丢失的精度可能会导致无限绘制的问题。

非常感谢levianye发现Bug并提出修复建议和PR。 非常感谢madongqiang2201发现Bug并提出修复建议。

　　BooheeRuler遵循MIT协议。

id：炎之铠

炎之铠的邮箱：[email protected]

CSDN：http://blog.csdn.net/totond


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK