Skip to content

Latest commit

 

History

History
211 lines (180 loc) · 8.59 KB

README.md

File metadata and controls

211 lines (180 loc) · 8.59 KB
Raw

EasyMoney-Widgets Quality Gate Status Build

Download Android Arsenal API API

The widgets (EditText and TextView) for support of money requirements like currency, number formatting, comma formatting etc.

NOTE: This library support ALL and ANY kind of currency. The currencies in the demo are just for example. The library is NOT limited to those currencies.

Source

Inspired from the android library EasyMoney-Widgets

Features

  • EasyMoneyEditText and EasyMoneyTextView widgets
  • Custom currency support added through string symbol, Locales, or Currency objects
  • Commas formatting support added
  • Show/hide currency symbol
  • Show/hide commas in the widgets
  • Get raw value in string or formatted value in string

Demo

Need to update once release is uploaded on Github

Installation

  1. For using EasyMoney-Widgets module in sample app, include the source code and add the below dependencies in entry/build.gradle to generate hap/support.har.
	dependencies {
		implementation project(':easymoneywidgetslibrary')
        	implementation fileTree(dir: 'libs', include: ['*.har'])
        	testCompile 'junit:junit:4.12'
	}
  1. For using EasyMoney-Widgets in separate application using har file, add the har file in the entry/libs folder and add the dependencies in entry/build.gradle file.
	dependencies {
		implementation fileTree(dir: 'libs', include: ['*.har'])
		testCompile 'junit:junit:4.12'
	}
  1. For using EasyMoney-Widgets from a remote repository in separate application, add the below dependencies in entry/build.gradle file.
	dependencies {
		implementation 'dev.applibgroup:easymoneywidgetslibrary:1.0.0'
		testCompile 'junit:junit:4.12'
	}

Usage

XML

EasyMoneyEditText in xml layouts (output will be $ 123,456,234)

 <com.wajahatkarim3.easymoneywidgets.EasyMoneyEditText
        ohos:id="$+id:moneyEditText"
        ohos:height="match_content"
        ohos:width="match_parent"
        ohos:text="123456234"
        ohos:text_input_type="pattern_number"
        showCurrencyEditText="true"
        showCommasEditText="true"
        currencySymbolEditText="$"/>

EasyMoneyTextView in xml layouts (output will be $ 123,456,234)

 <com.wajahatkarim3.easymoneywidgets.EasyMoneyTextView
        ohos:id="$+id:moneyTextView"
        ohos:height="match_content"
        ohos:width="match_parent"
        ohos:text="123456234"
        showCurrencyTextView="true"
        showCommasTextView="true"
        currencySymbolTextView="$"/>

Customization in XML

All customizable attributes for EasyMoneyEditText

Attribute Name Default Value Description
currencySymbolEditText="$" Chinese Yuan (¥) The currency symbol for the widgets
showCurrencyEditText="true" true Whether to show the currency symbol in the widgets
showCommasEditText="true" true Whether to show the commas between numbers in the widgets

All customizable attributes for EasyMoneyTextView

Attribute Name Default Value Description
currencySymbolTextView="$" Chinese Yuan (¥) The currency symbol for the widgets
showCurrencyTextView="true" true Whether to show the currency symbol in the widgets
showCommasTextView="true" true Whether to show the commas between numbers in the widgets

NOTE: The default value of currency symbol is set according to locale.

In Code (Java)

// Set the value for money widgets
moneyEditText.setText("23456.01");                          // $ 23,456.01
moneyTextView.setText("1234");                              // $ 1,234

// Get the value from money widgets
String valForm = moneyView.getFormattedString();            // $ 23,456.01
String valRaw = moneyView.getValueString();                 // 23456.01

// Set the currency of the money widgets
moneyView.setCurrency("€");                                 // € 23,456.01
moneyView.setCurrency(Locale.UK);                           // £ 23,456.01
moneyView.setCurrency(Currency.getInstance(Locale.US));     // $ 23,456.01

// Show/hide currency of the money widgets
moneyView.showCurrencySymbol();                             // $ 23,456.01
moneyView.hideCurrencySymbol();                             // 23,456.01
boolean curr = moneyView.isShowCurrency();                  // true if currency is shown

// Show/hide commas of the money widgets
moneyView.showCommas();                                     // $ 23,456.01
moneyView.hideCommas();                                     // $ 23456.01

Donations

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!

PayPal

  • Donate $5: Thank's for creating this project, here's a tea (or some juice) for you!
  • Donate $10: Wow, I am stunned. Let me take you to the movies!
  • Donate $15: I really appreciate your work, let's grab some lunch!
  • Donate $25: That's some awesome stuff you did right there, dinner is on me!
  • Donate $50: I really really want to support this project, great job!
  • Donate $100: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
  • Donate $2799: Go buddy, buy Macbook Pro for yourself!

Of course, you can also choose what you want to donate, all donations are awesome!

Developed By

Wajahat Karim

How to Contribute

  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. Create new Pull Request

License

Copyright 2016 Wajahat Karim

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.