/ElegantNumberButton

Widget which acts as a number counter which changes its number on +/- press.

Primary LanguageJava

Elegant Number Button

A simple Android library to implement a number counter with increment and decrement buttons.

Android Arsenal

Screens

Screen 1

Screen 1

Download

Grab the latest version on gradle using

compile 'com.cepheuen.elegant-number-button:lib:1.0.2'

or on maven

<dependency>
  <groupId>com.cepheuen.elegant-number-button</groupId>
  <artifactId>lib</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

Usage

For Working implementation of this library check ElegantNumberButtonSample App

  • Just include the view as you do with any android widget.

  • Implement it in your java code as anyother widget.

  • To get the number simply call getNumber() method on the button object.

  • To get the number from the button as soon as the button is clicked add a setOnClickListener to the view.

    ElegantNumberButton button = (ElegantNumberButton) findViewById(R.id.button);
    button.setOnClickListener(new ElegantNumberButton.OnClickListener() {
            @Override
            public void onClick(View view) {
                String num = button.getNumber();
            }
        });
  • Or use a valueChangeListener to listen for changes in value.

    elegantNumberButton.setOnValueChangeListener(new ElegantNumberButton.OnValueChangeListener() {
            @Override
            public void onValueChange(ElegantNumberButton view, int oldValue, int newValue) {
                Log.d(TAG, String.format("oldValue: %d   newValue: %d", oldValue, newValue));
            }
        });

Customization

backgroundColor : Set button Background color

initialNumber: Set initial number for the button.

finalNumber : Set final number range for button.

textColor: Modify the text color of the button.

textSize: Change text size of the button.

backgroundDrawable: Add drawable background for the button.

Methods

setNumber(Integer number): Update the number of the widget.

setRange(Integer startNumber, Integer finalNumber) : Set the operational range for the widget

setOnValueChangeListener(OnValueChangedListener listener): listen for changes in the value

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request

Changelog

Version 1.0.2

  • Added ValueChangeListener to listen for changes in values

Version 1.0.1

  • Added Range for the widget
  • Changed attribute from initialText to initialNumber

Version 1.0

  • Initial Release

Author

License

Copyright 2016 Ashik Vetrivelu

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.