An easy-to-use, customizable, Material Design ready Pattern Lock view for Android.
Specs
This library allows you to implement pattern locking mechanism in your app easily and quickly. It is very easy to use and there are plenty of customization options available to change the functionality and look-and-feel of this view to match your needs.
It also supports RxJava 2 view bindings, so if you are a fan of reactive programming (just like me), you can get a stream of updates as the user draws the pattern.
Download
This library is available in jCenter which is the default Maven repository used in Android Studio.
Gradle
dependencies {
// other dependencies here
compile 'com.andrognito.patternlockview:patternlockview:1.0.0'// Optional, for RxJava2 adapter
compile 'com.andrognito.patternlockview:patternlockview-reactive:1.0.0'
}
Spread Some ❤️
Usage
We recommend you to check the sample project to get a complete understanding of the library. The step-by-step implementation guide is as follows.
And that's it! Your PatternLockView is ready to rock. You might also want to remove the listeners when not needed, removePatternLockListener(mPatternLockViewListener);
Step 3 (Optional: ReactiveX Interface)
For the RxJava fanboys, this library supports RxJava 2 view bindings. You can subscribe to this view to get a stream of pattern change updates.
If you are not interested in getting the compound event, you should subscribe to patternComplete() and/or patternProgress() for the specific updates. Have a detailed look here.
Customization
There are several customization options available which you can use to completely change the look-and-feel and functionality of this view to match your needs.
XML (Quick and Easy)
You can add various attributes to the PatternLockView from your XML layout.
app:dotCount="3" // Change the no.of dots in a row (or column)
app:dotNormalSize="12dp" // Change the size of the dots in normal state
app:dotSelectedSize="24dp" // Change the size of the dots in selected state
app:pathWidth="4dp" // Change the width of the path
app:aspectRatioEnabled="true" // Set if the view should respect custom aspect ratio
app:aspectRatio="square" // Set between "square", "width_bias", "height_bias"
app:normalStateColor="@color/white" // Set the color of the pattern view in normal state
app:correctStateColor="@color/primary" // Set the color of the pattern view in correct state
app:wrongStateColor="@color/pomegranate" // Set the color of the pattern view in error state
app:dotAnimationDuration="200" // Change the duration of the animating dots
app:pathEndAnimationDuration="100" // Change the duration of the path end animaiton
JAVA (Programatically)
You can also programatically change the properties of the view, thereby having more control over it.
mPatternLockView.setViewMode(PatternLockView.PatternViewMode.CORRECT); // Set the current viee more mPatternLockView.setInStealthMode(true); // Set the pattern in stealth mode (pattern drawing is hidden)mPatternLockView.setTactileFeedbackEnabled(true); // Enables vibration feedback when the pattern is drawnmPatternLockView.setInputEnabled(false); // Disables any input from the pattern lock view completelymPatternLockView.setDotCount(3);
mPatternLockView.setDotNormalSize((int) ResourceUtils.getDimensionInPx(this, R.dimen.pattern_lock_dot_size));
mPatternLockView.setDotSelectedSize((int) ResourceUtils.getDimensionInPx(this, R.dimen.pattern_lock_dot_selected_size));
mPatternLockView.setPathWidth((int) ResourceUtils.getDimensionInPx(this, R.dimen.pattern_lock_path_width));
mPatternLockView.setAspectRatioEnabled(true);
mPatternLockView.setAspectRatio(PatternLockView.AspectRatio.ASPECT_RATIO_HEIGHT_BIAS);
mPatternLockView.setNormalStateColor(ResourceUtils.getColor(this, R.color.white));
mPatternLockView.setCorrectStateColor(ResourceUtils.getColor(this, R.color.primary));
mPatternLockView.setWrongStateColor(ResourceUtils.getColor(this, R.color.pomegranate));
mPatternLockView.setDotAnimationDuration(150);
mPatternLockView.setPathEndAnimationDuration(100);
Contribution
This library is inspired from AOSP's LockPatternView. There are lots of improvements and customization options added so that you can get started without any hassle. If you find a bug or would like to improve any aspect of it, feel free to contribute with pull requests.
Copyright 2017 aritraroy
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.
请发表评论