Android 自定义 View 刻度尺

项目地址:

ScaleView 项目地址

简介:

🌟适用于Android的刻度尺(标尺)控件。🔥高度自定义🔥内存占用低,纯绘制,不使用动画。

目录:

1.使用方式

2.使用示例

3.自定义属性

4.方法

5.监听

1.使用方式

使用方式一:Maven方式:

Step 1. 在 project 层级的 build.gradle 中,添加仓库地址:
allprojects {
    repositories {
        ...
        jcenter()
    }
}
Step 2. 在主 module 的 build.gradle 中添加依赖:
  • 最新版本
implementation 'com.chiului.library:scaleview:1.1.1'

使用方式二:Module 方式

Step 1. 下载源码
Step 2. 引入 Module

File --> New --> import Module

Step 3. 在主 Module 中添加 Module 依赖
implementation project(path: ':scaleview')

2.使用示例

示例1 示例2 示例3 示例4

2.1仅改变各种颜色样式:


<com.chiului.ScaleView
        android:id="@+id/scaleView"
        android:layout_width="match_parent"�
        android:layout_height="100dp"
        app:pointer_color="#03DAC5"
        app:num_color="#6200EE"
        app:low_scale_color="#DEB8B1"
        app:middle_scale_color="#3379F6"
        app:high_scale_color="#EA4335"
        app:baseLine_color="#3700B3"/>


2.2某项目内样式:


<com.chiului.ScaleView
       android:id="@+id/scaleView"
       android:layout_width="match_parent"
       android:layout_height="100dp"
       app:min_index="0"
       app:max_index="300"
       app:now_index="50"
       app:show_pointer_head="false"
       app:scale_position="top"
       app:pointer_margin_top="30"
       app:font_top="false"
       app:show_baseLine="false"
       app:pointer_top_protruding="
       app:low_scale_width="3"
       app:middle_scale_width="3"
       app:high_scale_width="3"
       app:pointer_width="3"
       app:low_pointer_margin="150"
       app:middle_pointer_margin="100"
       app:high_pointer_margin="50" />


2.3显示负数、向下视图、隐藏底线样式:


<com.chiului.ScaleView
       android:id="@+id/scaleView"
       android:layout_width="match_parent"
       android:layout_height="150dp"
       app:min_index="-100"
       app:max_index="100"
       app:now_index="0"
       app:show_baseLine="false"
       app:pointer_top="false"
       app:scale_position="center"
       app:font_top="false"
       app:pointer_margin_top="0"
       app:pointer_color="#03DAC5"
       app:num_color="#6200EE"
       app:low_scale_color="#DEB8B1"
       app:middle_scale_color="#3379F6"
       app:high_scale_color="#EA4335"/>


2.4显示整数、居中视图、隐藏指针头样式:


<com.chiului.ScaleView
       android:id="@+id/scaleView"
       android:layout_width="match_parent"
       android:layout_height="150dp"
       app:min_index="-100"
       app:max_index="100"
       app:now_index="0"
       app:show_baseLine="false"
       app:scale_position="center"
       app:scale_ratio="1"
       app:baseLine_margin_bottom="0"
       app:show_pointer_head="false" 
       app:pointer_color="#03DAC5"
       app:num_color="#6200EE"
       app:low_scale_color="#DEB8B1"
       app:middle_scale_color="#3379F6"
       app:high_scale_color="#EA4335"/>


3.自定义属性


属性 作用 默认值
name="min_index" format="integer" 最小刻度 0
name="max_index" format="integer" 最大刻度 100
name="now_index" format="integer" 当前刻度 50
name="scale_value" format="integer" 每格刻度的值 1
name="text_size" format="float" 刻度数值的字体大小 50f
name="pointer_width" format="float" 指针线宽度 3f
name="pointer_head" format="float" 指针头宽度 30
name="pointer_top" format="boolean" 指针是否向上 true
name="pointer_top_protruding" format="boolean" 指针是否向上突出 false
name="pointer_bottom_protruding" format="boolean" 指针是否向下突出(相对于刻度线来说,如下对齐情况中,指针线下面要长于刻度线) false
name="show_pointer_head" format="boolean" 是否显示针头 true
name="baseLine_width" format="float" 底线线宽度 5f
name="low_scale_width" format="float" 低刻度线宽度 1f
name="middle_scale_width" format="float" 中刻度线宽度 2f
name="high_scale_width" format="float" 高刻度线宽度 3f
name="line_interval" format="integer" 刻度与刻度之间的距离 30
name="baseLine_margin_bottom" format="integer" 所有元素(除了文字)与 View 底的距离(下边距为文字留位置) 50
name="pointer_margin_top" format="integer" 所有元素(除了文字)与 View 顶的距离(上边距为文字留位置) 50
name="left_margin_left" format="integer" 所有元素(除了文字)与 View 左边的距离 0
name="right_margin_right" format="integer" 所有元素(除了文字)与 View 右边的距离 0
name="font_margin_bottom" format="integer" 文字下边距(避免显示不全) 0
name="font_margin_top" format="integer" 文字上边距(避免显示不全) 40
name="low_pointer_margin" format="integer" 低刻度的边距(控制长度) 150
name="middle_pointer_margin" format="integer" 中刻度的边距(控制长度) 100
name="high_pointer_margin" format="integer" 高刻度的边距(控制长度) 50
name="middle_frequency" format="integer" 中刻度线频率 5
name="high_frequency" format="integer" 高刻度线频率 10
name="baseLine_color" format="color" 底线颜色 #C7C7C7
name="high_scale_color" format="color" 高刻度线颜色 #C7C7C7
name="middle_scale_color" format="color" 中刻度线颜色 #C7C7C7
name="low_scale_color" format="color" 低刻度线颜色 #C7C7C7
name="num_color" format="color" 刻度数值颜色 #01C5C6
name="pointer_color" format="color" 指针颜色 #FF8282
name="font_top" format="boolean" 字体是否要绘制在上面 true
name="scale_ratio" format="float" 显示的刻度数字与刻度比例(比如要显示小数的情况, 显示整数则设为 1):刻度 / 比例 = 显示刻度 10
name="sliding_ratio" format="float" 滑动距离比例(用于调整滑动速度):刻度间距离 * 滑动速度比例 = 每滑动多少距离改变状态 0.5
name="show_baseLine" format="boolean" 是否显示底线 true
name="units" format="float" 惯性滑动速率时间单位, 多少毫秒时间单位内运动了多少个像素 500
name="max_velocity" format="float" 最大滑动数率 15000
name="strokeCap" format="enum" Paint 的线帽: BUTT:无线帽,ROUND:圆角, SQUARE:矩形 SQUARE
name="scale_position" format="enum" 刻度线对齐:top:上对齐,center:居中对齐,bottom:下对齐 bottom

4.方法


方法 作用
setNowIndex(double) 设置刻度
setPlusScale() 加刻度
setMinusScale() 减刻度
setMaxIndex(double) 设置最小刻度范围
setMaxIndex(double) 设置最大刻度范围

5.监听


监听 作用
setOnScaleChangeListener(OnScaleChangeListener) 设置改变刻度回调监听
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349