masaliev/Masked-Edittext

Android library contain custom realisation of EditText component for masking and formatting input text

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.masaliev:masked-edittext:1.0.3'
	}

	dependencies {
		implementation("com.github.masaliev:masked-edittext:1.0.3")
	}

	<dependency>
	    <groupId>com.github.masaliev</groupId>
	    <artifactId>masked-edittext</artifactId>
	    <version>1.0.3</version>
	</dependency>


                            
    libraryDependencies += "com.github.masaliev" % "masked-edittext" % "1.0.3"


                            
    :dependencies [[com.github.masaliev/masked-edittext "1.0.3"]]

Readme

Masked-Edittext

Masked-Edittext android library EditText widget wrapper add masking and formatting input text functionality.

![Image phone number formatted input] (http://g.recordit.co/ROo3bzrX7k.gif)

![Image card number formatted input] (http://g.recordit.co/B8IuMTrsYi.gif)

Install

##Maven

<dependency>
  <groupId>com.github.pinball83</groupId>
  <artifactId>masked-edittext</artifactId>
  <version>1.0.3</version>
  <type>aar</type>
</dependency>

##Gradle

compile 'com.github.pinball83:masked-edittext:1.0.3'

#Usage ###Quick start You can choose using this widget thought declaring it in layout resource xml

<com.github.pinball83.maskededittext.MaskedEditText
                android:id="@+id/masked_edit_text"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:inputType="number"
                app:mask="8 (***) *** **-**"
                app:notMaskedSymbol="*"
                app:maskIcon="@drawable/abc_ic_clear_mtrl_alpha"
                app:maskIconColor="@color/colorPrimary"
                />

or programmatically create in source file

MaskedEditText maskedEditText = new MaskedEditText(this,
                "8 (***) *** **-**",
                "*",
                getResources().getDrawable(R.drawable.ic_account_circle),
                new MaskedEditText.MaskIconCallback() {
                    @Override
                    public void onIconPushed() {
                        System.out.println("Icon pushed");
                        //Invoke here contact list or just clear input
                    }
                });

###Attributes
MaskedEditText have following attributes

####XML ... app:mask = "8 () *** -" //mask app:notMaskedSymbol = "" //symbol for mapping allowed placeholders app:replacementChar = "#" //symbol which will be replaced notMasked symbol e.g. 8 (*) *** - will be 8 (###) ### ##-## by default it assign to whitespace app:deleteChar = "#" //symbol which will be replaced after deleting by default it assign to whitespace app:format = "[1][2][3] [4][5][6]-[7][8]-[10][9]" //set format of returned data input into MaskedEditText app:maskIcon = "@drawable/abc_ic_clear_mtrl_alpha" //icon for additional functionality clean input or invoke additional screens app:maskIconColor = "@color/colorPrimary" //icon tint color ...

####Java Simple instance

MaskedEditText editText = new MaskedEditText(context, "8 (***) *** **-**", "*"); //set mask to "8 (***) *** **-**" and not masked symbol to "*"

text setup and formatting

editText.setMaskedText("5551235567");                     //set text into widget it will be look like 8 (555) 123 55-67
editText.setFormat("[1][2][3] [4][5][6]-[7][8]-[10][9]"); //set format of returned data input into MaskedEditText e.g editText.getUnmaskedText() return 8 (555) 123 55-76

Widget instance with mask, icon button and callback

MaskedEditText maskedEditText = new MaskedEditText(this,
            "8 (***) *** **-**",
            "*",
            getResources().getDrawable(R.drawable.ic_account_circle),
            new MaskedEditText.MaskIconCallback() {
                @Override
                public void onIconPushed() {
                    System.out.println("Icon pushed");
                }
            });

Getting text

maskedEditText.getUnmaskedText() //return unmasked text
maskedEditText.getText()         //return mask and text