Home / Android / TextView/EditText

A lightweight, highly customizable and reliable OTP input field for Android

A lightweight, highly customizable and reliable OTP input field for Android
Information
Category: Android / TextView/EditText
Watchers: 2
Star: 24
Fork: 1
Last update: May 16, 2022
Resource links
https://github.com/stoyicker/otpview

OtpView

A lightweight, highly-customizable and reliable OTP input field for Android

Check out the sample app on the releases page or on Google Play!

CircleCI

Usage

Download 

repositories {
  jcenter()
}
dependencies {
  implementation "com.github.stoyicker.otpview:library:<version>"
}

Demo video
Compatible with Kotlin 100%
minSdkVersion 17
onSave/RestoreInstanceState drawing
LTR, RTL & top-to-bottom drawing
Fully customizable via state-based drawables drawing
Customizable attributes via XML All
Customizable attributes after inflation All

FAQ

Transitive dependencies/apk bloat?

None! The library only depends on a small set of annotations and constants needed to offer proper support for autocomplete as well as for Kotlin.

But I use Java, I don't want Kotlin bloat?!

The entire library is written in Java and Kotlin compatibility is achieved via annotations that do not make it to runtime. So neither Kotlin nor Java users get anything they don't want!

Full API reference

See defaults.xml for default values.

public int getBoxAmount()

Gets the amount of boxes currently in the view.

  • Returns: The amount of boxes currently in the view.
  • See also: R.attr#otp_boxAmount

public void setBoxAmount(@IntRange(from = 1) int newBoxAmount)

Sets the amount of boxes for the view. Boxes will be added at the end or removed from the end of the view. Note that the current text of the view will be affected by the amount of boxes changing, either because it is trimmed if boxes are removed, or because it gets appended spaces if boxes are added.

  • Parameters: newBoxAmount — The new amount of boxes that the view should have (minimum 1)
  • See also: R.attr#otp_boxAmount

public void setBoxMargin(@Px int newMargin)

Sets the margin for all sides of the boxes in the view.

  • Parameters: newMargin — The new margin for all sides of the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_start

@Px public int getBoxMarginStart()

Gets the start margin of the boxes in the view.

  • Returns: The start margin of the boxes in the view, in pixels.
  • See also: R.attr#otp_boxMargin_start

public void setBoxMarginStart(@Px int newMarginStart)

Sets the start margin for the boxes in the view.

  • Parameters: newMarginStart — The new start margin for the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_start

@Px public int getBoxMarginTop()

Gets the top margin of the boxes in the view.

  • Returns: The top margin of the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_top

public void setBoxMarginTop(@Px int newMarginTop)

Sets the top margin for the boxes in the view.

  • Parameters: newMarginTop — The new top margin for the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_top

@Px public int getBoxMarginEnd()

Gets the end margin of the boxes in the view.

  • Returns: The end margin of the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_end

public void setBoxMarginEnd(@Px int newMarginEnd)

Sets the end margin for the boxes in the view.

  • Parameters: newMarginEnd — The new end margin for the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_end

@Px public int getBoxMarginBottom()

Gets the bottom margin of the boxes in the view.

  • Returns: The bottom margin of the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_bottom

public void setBoxMarginBottom(@Px int newMarginBottom)

Sets the bottom margin for the boxes in the view.

  • Parameters: newMarginBottom — The new bottom margin for the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_bottom

public void setBoxPadding(@Px int newPadding)

Sets the padding for all sides of the boxes in the view.

  • Parameters: newPadding — The new padding for all sides of the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_start

@Px public int getBoxPaddingStart()

Gets the start padding of the boxes in the view.

  • Returns: The start padding of the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_start

public void setBoxPaddingStart(@Px int newPaddingStart)

Sets the start padding for the boxes in the view.

  • Parameters: newPaddingStart — The new start padding for the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_start

@Px public int getBoxPaddingTop()

Gets the top padding of the boxes in the view.

  • Returns: The top padding of the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_top

public void setBoxPaddingTop(@Px int newPaddingTop)

Sets the top padding for the boxes in the view.

  • Parameters: newPaddingTop — The new top padding for the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_top

@Px public int getBoxPaddingEnd()

Gets the end padding of the boxes in the view.

  • Returns: The end padding of the boxes in the view, in pixels.
  • See also: R.attr#otp_boxPadding_end

public void setBoxPaddingEnd(@Px int newPaddingEnd)

Sets the end padding for the boxes in the view.

  • Parameters: newPaddingEnd — The new end padding for the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_end

@Px public int getBoxPaddingBottom()

Gets the bottom margin of the boxes in the view.

  • Returns: The bottom margin of the boxes in the view, in pixels
  • See also: R.attr#otp_boxPadding_bottom

public void setBoxPaddingBottom(@Px int newPaddingBottom)

Sets the bottom padding for the boxes in the view.

  • Parameters: newPaddingBottom — The new bottom padding for the boxes in the view, in pixels
  • See also: R.attr#otp_boxMargin_bottom

@Nullable public Drawable getBoxBackground()

Gets the Drawable used as background for the boxes.

  • Returns: The Drawable used as background for the boxes
  • See also: R.attr#otp_boxBackground

public void setBoxBackgroundColorResource(@ColorRes int newColorRes)

Sets the color to be used as a background for the boxes.

  • Parameters: newColorRes — A resource pointing to the new color to be as a background for the boxes
  • See also: R.attr#otp_boxBackground

public void setBoxBackgroundDrawableResource(@DrawableRes int newDrawableRes)

Sets the drawable to be used as a background for the boxes.

  • Parameters: newDrawableRes — A resource pointing to the new Drawable to be as a background for the boxes
  • See also: R.attr#otp_boxBackground

public void setBoxBackground(@ColorInt int newColor)

Sets the color to be used as a background for the boxes.

  • Parameters: newColor — The new color to be as a background for the boxes
  • See also: R.attr#otp_boxBackground

public void setBoxBackground(final @Nullable Drawable newDrawable)

Sets the Drawable to be used as a background for the boxes.

  • Parameters: newDrawable — The new Drawable to be used as a background for the boxes
  • See also: R.attr#otp_boxBackground

public ColorStateList getBoxTextColor()

Gets the color for the text in the boxes.

  • Returns: A ColorStateList describing the color(s) for the text in the boxes
  • See also: R.attr#otp_boxTextColor

public void setBoxTextColorResource(@ColorRes int newColorRes)

Sets the color for the text in the boxes

  • Parameters: newColorRes — The resource for new color to use for the boxes where the code characters are shown. Use state_focused to apply different customization to a box when it is active
  • See also: R.attr#otp_boxTextColor

public void setBoxTextColorStateListResource(@ColorRes int newColorRes)

Sets the color for the text in the boxes.

  • Parameters: newColorRes — The resource for new ColorStateList to use for the boxes where the code characters are shown. Use state_focused to apply different customization to a box when it is active
  • See also: R.attr#otp_boxTextColor

public void setBoxTextColor(@ColorInt int newColor)

Sets the color for the text in the boxes.

  • Parameters: newColor — The new color to use for the boxes where the code characters are shown. Use state_focused to apply different customization to a box when it is active
  • See also: R.attr#otp_boxTextColor

public void setBoxTextColorStateList(final @NonNull ColorStateList newColorStateList)

Sets the color for the text in the boxes.

  • Parameters: newColorStateList — The new ColorStateList to use for the boxes where the code characters are shown. Use state_focused to apply different customization to a box when it is active
  • See also: R.attr#otp_boxTextColor

@Px public float getBoxTextSize()

Gets the size (in raw pixels) of the text in the boxes of this view.

  • Returns: The size (in raw pixels) of the text in the boxes of this view
  • See also: R.attr#otp_boxTextSize

public void setBoxTextSize(@Px float newTextSize)

Sets the size (in raw pixels) of the text in the boxes of this view.

  • Parameters: newTextSize — The size (in raw pixels) of the text in the boxes of this view
  • See also: R.attr#otp_boxTextSize

@Px public float getBoxTextScaledSize()

Gets the size (in scaled pixels) of the text in the boxes of this view.

  • Returns: The size (in scaled pixels) of the text in the boxes of this view
  • See also: R.attr#otp_boxTextSize

public void setBoxTextScaledSize(@Px float newTextSize)

Sets the size (in scaled pixels) of the text in the boxes of this view.

  • Parameters: newTextSize — The size (in scaled pixels) of the text in the boxes of this view
  • See also: R.attr#otp_boxTextSize

@BoxInputType public int getBoxInputType()

Gets the current input type of the view.

  • Returns: The current input type of the view, as specified by BoxInputType
  • See also: R.attr#otp_boxInputType

public void setBoxInputType(@BoxInputType int newBoxInputType)

Sets the input type of the view. This will condition the virtual input method shown on screen when the user interacts with the boxes.

  • Parameters: newBoxInputType — The desired new input type, any of BoxInputType
  • See also: R.attr#otp_boxInputType

@NonNull public String getText()

Gets the current text in the view as a representation built by putting together all characters in the view. Empty boxes are skipped, so the length of what you get may not match the amount of boxes in the view

  • Returns: A representation of the current text in the view
  • See also:
    • R.attr#otp_text
    • #getTextRaw()

public void setTextResource(final @StringRes int newTextRes)

Sets the text in the view. If the view is set to be masked, the text will not be revealed at all. The content is distributed one character per box, starting with the first box, this being the left-most one in LTR locales and the right-most one in RTL locales.

  • Parameters: newTextRes — The resource for the text to set in this view
  • See also: R.attr#otp_text

public void setText(final @NonNull CharSequence newText)

Sets the text in the view. If the view is set to be masked, the text will not be revealed at all. The content is distributed one character per box, starting with the first box, this being the left-most one in LTR locales and the right-most one in RTL locales.

  • Parameters: newText — The text to set in this view
  • See also: R.attr#otp_text

@NonNull public SparseArray<Character> getTextRaw()

Gets the characters currently in the view mapped to the position they occupy, 0-indexed.

  • Returns: A SparseArray holding the Characters currently in the view mapped to the position they occupy, 0-indexed. If a box is empty, the corresponding index will be missing from the object
  • See also: R.attr#otp_text

public void setTextRaw(final @NonNull SparseArray<Character> newTextRaw)

Sets the characters currently in the boxes.

  • Parameters: newTextRaw — A SparseArray of Character mapping the contents for each box to the index of that box (0-indexed) in the view
  • See also: R.attr#otp_text

public boolean isMasked()

Gets the masked state of the view.

  • Returns: true if the view is masked; false otherwise

public void setMasked(boolean newMasked)

Sets the masked state of the view.

  • Parameters: newMasked — true to mask the content in the view. false to un-mask it

@Nullable public Drawable getBoxMask()

Gets the Drawable used as mask for the boxes.

  • Returns: The Drawable used as mask for the boxes
  • See also: R.attr#otp_boxMask

public void setBoxMaskColorResource(@ColorRes int newColorRes)

Sets the color to be used as a mask for the boxes.

  • Parameters: newColorRes — A resource pointing to the new color to be as a mask for the boxes
  • See also: R.attr#otp_boxMask

public void setBoxMaskDrawableResource(@DrawableRes int newDrawableRes)

Sets the drawable to be used as a mask for the boxes.

  • Parameters: newDrawableRes — A resource pointing to the new Drawable to be as a mask for the boxes
  • See also: R.attr#otp_boxMask

public void setBoxMask(@ColorInt int newColor)

Sets the color to be used as a mask for the boxes.

  • Parameters: newColor — The new color to be as a mask for the boxes
  • See also: R.attr#otp_boxMask

public void setBoxMask(final @Nullable Drawable newDrawable)

Sets the Drawable to be used as a mask for the boxes.

  • Parameters: newDrawable — The new Drawable to be used as a mask for the boxes
  • See also: R.attr#otp_boxMask

public void setOrientation(int orientation)

  • See also:
    • LinearLayout#setOrientation(int)
    • android.R.attr#orientation

public void setLayoutDirection(int layoutDirection)

  • See also:
    • View#setLayoutDirection(int)
    • android.R.attr#layoutDirection

public void registerOtpInputListener(final @NonNull OtpInputListener listener)

Adds an OtpInputListener to listen for input changes if it isn't already registered. For most cases, it is recommended that you use an instance of SimpleOtpInputListener

  • Parameters: listener — The OtpInputListener to register
  • See also:
    • #unregisterOtpInputListener(OtpInputListener)
    • SimpleOtpInputListener

public boolean unregisterOtpInputListener(final @NonNull OtpInputListener listener)

Removes a previously registered OtpInputListener, if it is indeed registered.

  • Parameters: listener — The OtpInputListener to unregister
  • Returns: true if the listener was found among the registered ones (and, therefore, unregistered). false otherwise
  • See also: #registerOtpInputListener(OtpInputListener)

public boolean requestFocus(int direction, final @Nullable Rect previouslyFocusedRect)

  • See also: #requestFocusFirstBlankBox()

public boolean requestFocusFirstBlankBox()

Gives focus to the first box without text. Note that when a box gains focus, it (1) becomes active, (2) erases its text, if any, and (3) shows the soft keyboard.

  • Returns: true if a box (regardless of whether it was focused before or not) has requested focus. false otherwise.
0 Open More issues
Closed

Revert "Remove dependency from publish to assemble"

This reverts commit b471996244c6fc3ecf461d9fb4b5b237e2c1f239.

opened Jun 16, 2021 by stoyicker 0
Closed

Use attach_workspace when releasing to central

opened Jun 16, 2021 by stoyicker 0
Closed

Remove extra line

opened Jun 16, 2021 by stoyicker 0
Closed

Bump version

opened Jun 16, 2021 by stoyicker 0
Closed

Work

opened Jun 16, 2021 by stoyicker 0
Closed

Fix task name in dependency

opened Jun 16, 2021 by stoyicker 0

Contents

    Mindinventory A custom verification code view with inbuild validations & Auto fill OTP on keyboard, which can be used for OTP(One time password), verification codes.
    SciresM view and extract data from a 3DS OTP
    AqibMukhtar A lightweight JavaScript package for generating and validating OTP (One Time Password) maintaining high performance using in-memory database.
    sixlive Nova text field with click to copy support
    LiewJunTung A highly customisable Flutter widget for entering pin code. Suitable for use cases such as login and OTP.
    yeojz otplib is a JavaScript One Time Password (OTP) library for OTP generation and verification.
    teckwei1993 A package for Laravel One Time Password (OTP) generator and validation without Eloquent Model, since it done by Cache.
    apptension CLI client for RFC 4226's HOTP and RFC 6238's TOTP.
    evansmurithi cloak — A Command Line OTP (One Time Password) Authenticator application.
    reiallenramos Nuxt with JWT authentication via OTP - A Nuxt.js boilerplate with basic register and OTP-enabled login functions.
    erdemkeren A laravel package to protect your routes with one time passwords (otp)
    huextrat Phone number authentication + OTP login page built with @flutter 😍
    kadetXx 🛠 Highly customisable, minimalistic input x select field for React.
    olach Sortable multiselect field for Kirby 2 CMS
    Daandelange A tabs field for the panel, to use with $field->when() conditions.
    mattt A colorful visualization of password field input
    adam-hanna A dead simple, highly performant, highly customizable sessions middleware for go http servers.
    kirualex Lightweight, highly customizable Pin Code Field library for iOS, written in Swift
    xamous A cross-platform, smooth, lightweight, customizable PIN code input component for React Native.
    pandulapeter A smart, reliable, and highly customizable debug menu for Android apps
    SimformSolutionsPvtLtd SSCalendarControl is small and highly customizable calendar control written in swift.
    Share this repo

    Related Repos


    TextView/EditText
    9
    Ultralight, a HTML + CSS renderer for Fabric
    isXander Xander's Fabric Template for Kotlin The best Fabric template using kotlin. Usage Mod Development: Please read the Fabric Wiki for general mod developm
     
    TextView/EditText
    3
    This is a collection of phone numbers on the back of credit cards
    USCreditCardGuide Credit Cards Phone Numbers This is a collection of phone numbers on the back of credit cards. Many of them are blank for now because we don't have tho
     
    TextView/EditText
    11
    Date text field with on the fly validation
    LanarsInc Date text field with on the fly validation
     
    TextView/EditText
    22
    Socially is a textView which is able to create separate clickable views according to your ...
    enofeb Socially Socially is a textView which is able to create separate clickable views according to your requirements. Sample Video Simple Usage <com.enofeb
     
    TextView/EditText
    33
    This is an android library to represent password strength.
    RHSaliya This is an android library to represent password strength.
     
    TextView/EditText
    15
    TagEditText - A simple Android Tag EditText
    hearsilent TagEditText - A simple Android Tag EditText
     
    TextView/EditText
    78
    A simple library for hide and show text with animation.
    mike5v ViewMore TextView allows you to use a TextView by hiding the content of the text by a number of established lines and to display all the content expanding the TextView by a collapsing/expanding animation. It's possibile use an ellipses text or a foreground color gradient or both to hide the content.
     
    TextView/EditText
    30
    ExpandableTextView - Read More TextView for Android
    YKW93 ExpandableTextView - Read More TextView for Android
     
    TextView/EditText
    24
    A lightweight, highly customizable and reliable OTP input field for Android
    stoyicker A lightweight, highly customizable and reliable OTP input field for Android
     
    TextView/EditText
    22
    Phonemoji - International phone number input field for Android with emoji flags
    tfcporciuncula Phonemoji provides a flexible text input field implementation that formats international phone numbers as you type and displays the flag of the country that matches the number's country code
     
    TextView/EditText
    228
    Android类似支付宝密码输入框，美团外卖验证码输入框，验证码粘贴等；
    Chen-keeplearn Android类似支付宝密码输入框，美团外卖验证码输入框，验证码粘贴等；有效果图，有demo；支持下划线，方框，连体框样式；可设置光标、光标颜色，下划线输入时高亮，边框大小、颜色、圆角等等；设置密码显示的样式
     
    TextView/EditText
    567
    A simple way to format text fields without getting affected by input filters.
    santalu A simple way to format text fields without getting affected by input filters.
     
    TextView/EditText
    10
    android-word-scrapper
    ZiyadKhalil This is a task that was required for the instabug internship program 2020 that did not pass the task phase despite being good enough to pass
     
    TextView/EditText
    11
    Super easy TextView with 'Read More'
    PRNDcompany Super easy TextView with 'Read More'
     
    TextView/EditText
    282
    Pdf Viewer For Android
    afreakyelf A Simple PDF Viewer library which only occupies around 125kb while most of the Pdf viewer occupies upto 16MB space.