PinEntryEditText for Android
This repository contains PinEntryEditText which extends the behaviour of EditText and implement features that are otherwise not available.
Features
PinEntryEditText
- Number of pin characters is configurable. You can use the
maxLengthproperty to define however long you want your pin to be. - PinEntryEditText which supports text animating in.
- Lets you specify any unicode character to be used as a mask for input.
- Specify drawable as the foreground/background.
Usage
Below is a fast guide to getting started. However, if you need to read about these widgets in details. Read more about PinEntryEditText.
STEP-1
Gradle
dependencies {
compile 'com.alimuzaffar.lib:pinentryedittext:1.3.1'
}
STEP-2
Setup PinEntryEditText in your layout
<com.alimuzaffar.lib.pin.PinEntryEditText
android:id="@+id/txt_pin_entry"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:cursorVisible="false" //recommended
android:digits="1234567890"
android:inputType="number"
android:maxLength="4" //required
android:textIsSelectable="false" //recommended
android:textSize="20sp"
app:pinBackgroundDrawable="@drawable/bg_pin" //optional, use your own pin char background
app:pinAnimationType="popIn|fromBottom|none" //optional, default popIn app:pinCharacterMask="*" //optional, default bullet app:pinSingleCharHint="#" //optional, hint for each characters app:pinTextBottomPadding="@dimen/space" //optional, space between character and bottom line. app:pinLineStroke="2dp" //the stroke (height) of the bottom line by default. app:pinLineStrokeSelected="4dp" //the stroke (height) of the bottom line when field is focused. app:pinBackgroundIsSquare="true|false" //optional, if you want the background drawable to be a square or circle width of each digit will be set to match the height of the widget.
app:pinLineColors="@color/pin_line_colors" /> //optionalListen for pin entry
final PinEntryEditText pinEntry = (PinEntryEditText) findViewById(R.id.txt_pin_entry);
if (pinEntry != null) {
pinEntry.setOnPinEnteredListener(new PinEntryEditText.OnPinEnteredListener() {
@Override
public void onPinEntered(CharSequence str) {
if (str.toString().equals("1234")) {
Toast.makeText(AnimatedEditTextWidgetsActivity.this, "SUCCESS", Toast.LENGTH_SHORT).show();
}
else {
Toast.makeText(AnimatedEditTextWidgetsActivity.this, "FAIL", Toast.LENGTH_SHORT).show();
pinEntry.setText(null);
}
}
}
);
}
Use your own Drawable as a pin character background
You can use your own drawable for the pin entry background by specifying the app:pinBackgroundDrawable attribute in the xml. If you want to specify the empty and filled states using your background drawable you can set the textColor to transparent and setup your drawable as follows:
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<!-- Space contains text -->
<item android:state_focused="true" android:state_checked="true">
<shape android:shape="rectangle">
<solid android:color="@android:color/holo_green_light"/>
</shape>
</item>
<!--Space is the next space for character input -->
<item android:state_focused="true" android:state_selected="true">
<shape android:shape="rectangle">
<solid android:color="@android:color/holo_blue_bright"/>
</shape>
</item>
<!-- PinEntryEditText is focused -->
<item android:state_focused="true">
<shape android:shape="rectangle">
<solid android:color="@android:color/white"/>
</shape>
</item>
<!-- PinEntryEditText is not focused -->
<item>
<shape android:shape="rectangle">
<solid android:color="@android:color/darker_gray"/>
</shape>
</item> </selector>Note that in this setup, the size of the drawable will be determined by the textSize and and the pinTextBottomPadding which is the space between the character and the line below (or the bottom of the pinBackgroundDrawable). For good measure, set pinAnimationType to none as well.
Effects :
- PopIn (default)
- Bottom Up
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.