A module designed to encapsulate the use of an Textfield for gathering currency information from a user. Supports all ISO-3166 compliant locales/currencies.
Add a reference to mavenCentral() in the build.gradle of the project
repositories {
...
mavenCentral()
...
}
Add dependencies in the entry's build.gradle
dependencies {
...
implementation 'com.gitee.archermind-ti:CurrencyEditText:1.0.1'
...
}
Using the module is not much different from using any other EditText view. Simply define the view in your XML layout:
<com.blackcat.currencyedittext.CurrencyEditText
ohos:id="$+id:cet"
ohos:top_margin="10vp"
ohos:height="match_content"
ohos:text_size="16fp"
ohos:width="match_parent"
/>
You're done! The CurrencyEditText
module handles all the string manipulation and input monitoring required to allow for a clean, easy-to-use
currency entry system.
In its default state, CurrencyEditText
view appears as an EditText
box with the hint set to the users local currency symbol.
As a user enters additional values, they will appear starting with the right-most digit, pushing older digit entries left as they type.
Depending on the users Locale and Language settings, the displayed text will automatically be formatted to the users local standard. For example, when the users selects "German", the Euro symbol appears on the right, as seen below.
By default, CurrencyEditText
provides a 'hint' value for the text box. This default value is the Currency Code symbol for the users given Locale setting. This is
useful for debugging purposes, as well as provides clean and easy to understand guidance to the user.
If you'd prefer to set your own hint text, simply set the hint the same way you would for any other EditText
field. You can do this either in your XML layout
or in code. To remove the hint entirely, set the hint to an empty string ("").
By default, CurrencyEditText
does not allow negative number input. This is due to the fact that by far the most common use-case for currency input involves transaction information, where the absolute value of the transaction is entered separately from declaring a deposit or withdrawl.
However, if you do need to support negative number input, you can enable it by setting the allow_negative_values attribute.
In xml:
<com.blackcat.currencyedittext.CurrencyEditText
ohos:layout_width="match_parent"
ohos:layout_height="match_content"
app:allow_negative_values="true"
/>
In java:
CurrencyEditText tb = (CurrencyEditText) findComponentById(ResourceTable.Id_test);
tb.setAllowNegativeValues(true);
You can also set the decimal digits position (see below) via xml or java
In xml:
<com.blackcat.currencyedittext.CurrencyEditText
ohos:layout_width="match_parent"
ohos:layout_height="match_content"
app:decimal_digits="0"
/>
In java:
CurrencyEditText tb = (CurrencyEditText) findComponentById(ResourceTable.Id_test);
tb.setDecimalDigits(0);
As CurrencyEditText
is an extension of the EditText
class, it contains all the same getters and setters that EditText
provides.
To retrieve the fully formatted String value as shown to the user, simply call your CurrencyEditText
objects getText()
method.
However, you'll likely need to actually do something useful with the users input. To help developers more easily retrieve this information, CurrencyEditText
provides the getRawValue()
method. This method provides back the raw numeric values as they were input by the user, and should be treated as if it were a whole value of the users local currency.
For example, if the text of the field is $13.37, this method will return a Long with a value of 1337, as penny is the lowest denomination for USD.
It is the responsibility of the calling application to handle this value appropriately. Keep in mind that dividing this number to convert it to some other denomination could possibly result in floating point rounding errors, and should be done with great caution.
To assist with needing to perform work on locale-specific values after retrieval, CurrencyEditText
provides the getLocale() method which returns the locale currently being used by that instance for its formatting.
CurrencyEditText relies on a Locale
object to properly format the given value. There are two Locale
variables that are exposed via getters and setters on a given CurrencyEditText
object: locale and defaultLocale.
locale
is the users default locale setting based upon their OpenHarmony configuration settings. This value is editable by the user in OpenHarmony settings, as well as via the CurrencyEditText
API. Note that this value, when retrieved from the end-users device, is not always compatible with ISO-3166. This is used as the "happy path" variable, but due to the potential lack of ISO-3166 compliance, CurrencyEditText
will fall back to defaultLocale
in the event of an error.
defaultLocale
is a separate value which is treated as a fallback in the event that the provided locale value fails. This may occur due to the locale
value not being part of the ISO-3166 standard. See Java.util.Locale.getISOCountries()
for a list of supported values. Note that the list of supported values is hard-coded into each version of Java, therefore over time, the list of supported ISO's may change.
The default value for defaultLocale is Locale.US
. Both this, and the locale value, can be overwritten using setters found on the CurrencyEditText
object. Be very careful to ensure that should you override defaultLocale's value, you only use values supported by ISO-3166, or an IllegalArgumentException will be thrown by the formatter.
If you'd like to retrieve a formatted version of a raw value you previously accepted from a user, use the formatCurrency()
method of CurrencyEditText
. It takes one parameter: a string representing the value you'd
like to have formatted. It is expected that this value will be in the same format as the returning value from the getRawValue()
method. For example:
//rawVal contains "1000"
CurrencyEditText cet = new CurrencyEditText();
... user inputs "$10.00"
//rawVal is 1000
Long rawVal = cet.getRawValue();
//formattedVal accepts "1000" and returns "$10.00"
String formattedVal = cet.formatCurrency(Long.toString(rawVal));
//or
String formattedVal = cet.formatCurrency(rawVal);
By default, the CurrencyEditText
text formatter will use the locale
object to obtain information about the expected currency. This includes the location of the decimal separator for lower denominations (e.g. dollars vs. cents). If you would like to alter the decimal placement position, you can use the setDecimalDigits() method. This is very useful in some cases, for instance, if you only wish to show whole dollar amounts.
CurrencyEditText cet = new CurrencyEditText();
... user inputs 1000
//currentText is "$10.00"
String currentText = cet.getText();
cet.setDecimalDigits(0);
//newText is "$1,000"
String newText = cet.getText();
DecimalDigits can also be set in the XML layout if you don't want to obtain a java reference to the view.
Note that the valid range of DecimalDigits is 0 - 340. Any value outside of that range will throw an IllegalArgumentException
.
This repo contains the entry project which provides a testing application to showcase CurrencyEditText
functionality. You're encouraged to pull down and run the app to get a feel for how CurrencyEditText
works.
CurrencyEditText
is designed to be a small, lightweight module to provide ease-of-use to developers. If there is functionality missing that you would like to see added, submit a new Issue and label it as an Enhancement, and I will take a look. I make no guarantees that I will agree to implement it.
As called out in the Apache license (which this project falls under), by using this software you agree to use it AS-IS. I make no claims that this code is 100% bug-free or otherwise without issue. While I've done my best to ensure that rounding errors don't come into play and that all codeflows have been tested, I cannot guarantee or provide any sort of warranty that this code will work for you. The onus is on you, and you alone, to analyze this software and determine if it's featureset and quality meet your needs.
Run
to run (the real machine may need to configure the signature)Copyright 2017 BlacKCaT27
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.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型