Skip to content

Latest commit

 

History

History
177 lines (141 loc) · 4.7 KB

README.md

File metadata and controls

177 lines (141 loc) · 4.7 KB
Raw

Odometer

This is an Android Library for making Odometer with little customization with reading, slots, colors, font and size.
Example is available in app module.

screenshot screenshot

-->

Usage

  • Create Odometer with their properties.
    <com.androidchils.odometer.Odometer
        android:layout_width="match_parent"
        android:layout_height="wrap_content"> 
    </com.androidchils.odometer.Odometer>
  • Add Background
    You can change odometer background.
    chils:np_backgroundColor="@drawable/gradient"
  • Add BackgroundColor
    You can change odometer background color. You can put drawable and color too.
    chils:np_backgroundColor="@drawable/gradient"
  • Add Reading
     chils:np_reading="0000"
  • Add Slots
    chils:np_slots="4"
  • Add TextColor
    chils:np_textColor="@color/white"
  • Add TextSize
    chils:np_textSize="18sp"
  • Add custom font from .ttf. Put your .ttf file at assets\fonts. Font will apply everywhere title, content, buttons 
    chils:np_font="@string/lato_regular"
  • Those attributes necessary to add reading and slots together in Odometer 
    chils:np_reading="0000"
    chils:np_slots="4"

Odometer

  • You can even use the Odometer alone.
     <com.androidchils.odometer.Odometer
             android:id="@+id/odometer"
             android:layout_width="match_parent"
             android:layout_height="100dp"
             chils:np_background="@color/color_transparent"
             chils:np_backgroundColor="@drawable/gradient"
             chils:np_font="@string/lato_regular"
             chils:np_reading="0000"
             chils:np_slots="4"
             chils:np_textColor="@color/white"
             chils:np_textSize="18sp" />

Layout Customization

If you want to get the value of Odometer scrolling value you can create your own.

Note: You can see an example layout in both sample and library modules.

Example XML layout:

     <TextView
            android:id="@+id/tvOutPut"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:layout_marginTop="20dp"
            android:textColor="@color/black"
            android:textSize="18sp" />
    
        <Button
            android:id="@+id/btn_submit"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:layout_marginTop="20dp"
            android:background="@color/black"
            android:text="Submit"
            android:textColor="@color/white"
            android:textStyle="bold" />

Set a listener to be notified when value has changed:

        btn_submit.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                tvOutPut.setText(odometer.getFinalOdoMiterValue());
            }
        });

License

    Apache Version 2.0

    Copyright 2017.

    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.