FormattEditText

KO | EN

gitlite — search

#python #react #ai #typescript #deep-learning #docker #macos #java #windows #cli #kubernetes #vue #awesome-list #security

FormattEditText

(★ 183)

Android library with formatted input fields

FormattEditText Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-FormattEditText-green.svg?style=true)](https://android-arsenal.com/details/1/3974)
[![Download](https://api.bintray.com/packages/paxlich/maven/formatt-edit-text/images/download.svg)](https://bintray.com/paxlich/maven/formatt-edit-text/_latestVersion)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/PaXLiCh/FormattEditText/blob/master/LICENSE)

# Formatted EditText

Useful components for formatting phone numbers, prices, counters. Simple implementations of a EditText widgets, which can help to visualize inputted text. Classes are inherited from AppCompatEditText.

**MaskedEditText** based on code of [Reinaldo Arrosi](https://github.com/reinaldoarrosi/MaskedEditText)

## Integration

Add the library project or grab to build.gradle:
```groovy
compile 'ru.kolotnev:formatt-edit-text:0.8'
```
or plain maven:
```maven
<dependency>
  <groupId>ru.kolotnev</groupId>
  <artifactId>formatt-edit-text</artifactId>
  <version>0.8</version>
  <type>pom</type>
</dependency>
```

## Usage

### Masked EditText

Insert the view in XML:

```xml
    <ru.kolotnev.formattedittext.MaskedEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text=""
        app:mask="+999-9A?*"
        app:placeholder="_"/>
```

#### Properties:

- mask &mdash; mask for text
- placeholder &mdash; character will be shown where an input is expected an by default the placeholder char is a white-space

#### Methods:

**setMask(String mask)**
This is used to set a mask. MaskedEditText will try to match the current text with the new mask, so if you change the mask and your text is still valid you'll not lose it.

**getMask()**
This method returns the current mask.

**setPlaceholder(char placeholder)**
This is used to set the placeholder character. This character is shown where an input is expected an by default the placeholder char is a white-space

**getPlaceholder()**
This method returns the current character that is being used as the placeholder char.

**getText(boolean removeMask)**
This method is exactly like getText() except that you're able to pass a parameter that will determine if the value returned will contain the mask characters or not.

#### Mask
The mask is a simple sequence of character where some of these have a special meaning. Any character that does not have a special meaning will be treated as a literal character and will appear as is in the MaskedEditText.

These are the chars that have a special meaning within the mask:
- 9 &mdash; Numeric mask (this will accept only numbers to be typed)
- A &mdash; Alpha mask (this will accept only alphabetic letters to be typed)
- \* &mdash; Alphanumeric (this will accept numbers and alphabetic letters to be typed)
- ? &mdash; Character mask (this will accept anything to be typed)

###### Examples:
- phone mask: `(999) 999-9999`
- money: `$999,999,999.99`
- random valid mask: `(A)?*99A-9++*??`

###### Escape char:

If you need one of these special chars to be treated as a literal char you can use the escape char `\` in front of it:

> Please note that each character `\` must be also escaped, so the number of escapes is always doubled to be `\\`

Example: Suppose that in the phone mask we need to add a preceding digit that will always be 9, to do this we can change the mask like this:
- phone mask: `\\9(999) 999-9999`

If you need to display the escape char as a literal char just double the escape char like this:
- phone mask: `\\\\(999) 999-9999`

Escape chars are escape only one character `\`. Therefore, the following literal characters must be also written with the escape character:
- phone mask: `\\\\\\9(999) 999-9999`

Do not specify `android:inputType`, it will be automatically set on the fly by specified mask string. If mask string contains only numeric mask characters (and literals), `InputType` will be set to `TYPE_CLASS_NUMBER`, otherwise `TYPE_CLASS_TEXT`.

### Decimal EditText

Insert the view in XML:

```xml
    <ru.kolotnev.formattedittext.DecimalEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:inputType="numberSigned"
        app:plural="@plurals/plural_decimal_test_decimal"
        app:rounding="3"/>
```

#### Properties:

- plural &mdash; plural resource
- rounding &mdash; amount of digits after comma (zero for integer)

#### Methods:

**BigDecimal getValue()**
Returns decimal value from entered text.

**setValue(BigDecimal value)**
Sets new value and updates view.

**int getDecimalRounding()**
Gets current amount of fraction digits.

**setDecimalRounding(int decimalRounding)**
Sets amount of fraction digits for formatting and identifying decimal.

**int getPluralResource()**
Gets resource ID of plural for formatting view of input field.

**setPluralResource(int pluralResource)**
Sets plural for formatting of current value with label and updates view.

**setFormat(int decimalRounding, int pluralResource)**
Set whole format of edit text field for displaying decimal value.

**setLimits(BigDecimal min, BigDecimal max)**
Sets the limits for value which can be entered (both ZERO limits means no limits).

### Currency EditText

Insert the view in XML:
```xml
    <ru.kolotnev.formattedittext.CurrencyEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:currency="USD"
        app:locale="fr"/>
```

#### Properties:

- currency &mdash; currency code in ISO 4217
- locale &mdash; locale code in ISO 639

#### Methods:

**BigDecimal getValue()**
Get current decimal value for currency.

**setValue(BigDecimal bigDecimal)**
Sets new value for edit field.

**Locale getLocale()**
Gets current locale for text field.

**setLocale(Locale locale)**
Sets locale for text field.

**Currency getCurrency()**
Returns current currency for text field.

**setCurrency(Currency currency)**
Sets new currency for text field.

## License
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.

FormattEditText

FormattEditText Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

FormattEditText

FormattEditText Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README