Ruler

Additional

Language
Java
Version
1.0.5 (Jan 26, 2024)
Created
Jun 14, 2018
Updated
Jan 28, 2024
Owner
TangKe
Contributor
TangKe
1
Activity
Badge
Generate
Download
Source code

Advertisement

Ruler

查看中文介绍

Provide a horizontal scrollable ruler widget, developer can get the value which user scrolled to.

The widget is drawn by canvas. All elements is customizable.

Provide a style by default.

Customizable elements:

  • distance between two scale
  • scale color
  • ruler color(underline)
  • scale group count
  • indicator(a drawable alway show in center)
  • scale height
  • scale widget
  • ruler height
  • label text color
  • label text size
  • format of the label
  • custom clickable marker
  • two finger zoom

Install

Add following lines in your app build.gradle file

dependencies {
  implementation 'ke.tang:ruler:1.0.5'
}

How to use

  1. In xml layout

    <?xml version="1.0" encoding="utf-8"?>
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">
    
        <ke.tang.ruler.RulerView
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />
    
    </LinearLayout>
  2. Or use RulerView as normal view in your Java code, About the api please view the Javadoc for detail.

Attributes

Attribute Name Attribute Type Description
stepWidth dimension Distance between scales
rulerValueFormatter string Ruler value formter class full name, must a subclass of RulerValueFormatter
scaleColor color|reference Scale color
rulerColor color|reference Ruler color(underline)
sectionScaleCount integer Scale group count
scaleMinHeight dimension Secondary scale height
scaleMaxHeight dimension Primary scale height
scaleSize dimension Scale width
rulerSize dimension Ruler height(underline)
indicator reference Indicator(always displayed in center)
maxValue integer Value upper limit(0-10000)
minValue integer Value lower limit(0-10000)
value integer Current value(0-10000)
android:textSize dimension Label text size
android:textColor color|reference Label text color

License

    Copyright 2018 TangKe

    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.