AnimatedEditText for Android
This repository contains AnimatedEditText
and TextDrawable
all of which extend the behaviour of EditText
and implement features that are otherwise not available.
NOTE: PinEntryEditText
has been moved to it's own repo on GitHub.
Features
AnimatedEditText
- Text animates in as typed (4 animations available).
- Text animates out when cleared using
setText(null)
orsetText("")
. - Smooth forward movement of cursor (API 16+).
- Smooth backward movement of cursor when clear is called (API 16+, see known issues).
- Lets you specify any character to be used as a mask for input.
PinEntryEditText
PinEntryEditText has been moved to it's own repo on GitHub.
Others
- TextDrawable which allows you to set and use text as a drawable.
Usage
Below is a fast guide to getting started. However, if you need to read about these widgets in details. Read more about AnimatedEditText, PinEntryEditText, TextDrawable.
STEP-1
Gradle
dependencies {
implementation ('com.alimuzaffar.lib:animated-edit-text:2.0.2') {
// Exclude is only needed if you already have the library
// mentioned below as a dependency in your app
exclude group: 'androidx.appcompat', module: 'appcompat'
}
}
If not using Jetpack use version 1.x
dependencies {
implementation ('com.alimuzaffar.lib:animated-edit-text:1.2.3') {
// Exclude is only needed if you already have the library
// mentioned below as a dependency in your app
exclude group: 'com.android.support', module: 'appcompat-v7'
}
}
Note: You don't need to exclude all the support groups. However, it's a good idea to do this as your code is likely to use a different version from the library.
STEP-2
Setup AnimatedTextView and PinEntryView in your layout
<com.alimuzaffar.lib.widgets.AnimatedEditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="Animate pop in"
android:inputType="textNoSuggestions" //recommended when typing text to avoid autocomplete.
app:animationType="popIn|fromBottom|fromRight|fromMiddle|none" //Optional, default popIn
app:animateCursor="true|false" //Optional, default true
app:animateTextClear="true|false" /> //Optional, default true
Use in your code
Use in your code like you would use a regular EditText
EditText regular = (AnimatedEditText) findViewById(R.id.txt_regular);
if (regular != null) {
String input = regular.getText().toString();
}
Effects :
- PopIn (default)
- Bottom Up
- In from right
- In from middle
Demo
Pop-in animation
Bottom Up Animations
In from right
In from middle
You can see a YouTube video of all the animations here: YouTube video
Issues :
- Only works for single line input, the second the line has to wrap, the animation breaks.
- Animation will work best if
android:inputType="textNoSuggestions"
is set. - Animations are only triggered when adding to the end of the string.
- Only
android:gravity="left|right|center_horizontal"
is supported. - Smooth back movement of cursor when text is cleared doesn't work too well for
android:gravity="center_horizontal"
- No RTL language support.
- Animate in from middle doesn't work properly except from
android:gravity="left"
- Not all features of EditText will work
- Using some Unicode characters as masks causes the cursor to lose position. If this happens, I recommend setting cursor visibility to false or setting textPassword or numberPassword as the input type for the fields which improves the situation but doesn't really solve it in all cases.
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.