Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

react-auth-code-input

Package Overview
Dependencies
Maintainers
1
Versions
11
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

react-auth-code-input

One-time password (OTP) React input component, uncontrolled, zero dependencies, fully tested.

  • 3.2.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
58K
increased by114.53%
Maintainers
1
Weekly downloads
 
Created
Source

image

React Auth Code Input

One-time password (OTP) React component, zero dependencies, fully tested.

NPM JavaScript Style Guide Software License npm npm GitHub actions state

Demo

Demo

Install

npm install --save react-auth-code-input

or

yarn add react-auth-code-input

Version 3+

Basic Usage

import React, { useState } from 'react';
import AuthCode from 'react-auth-code-input';

const App = () => {
  const [result, setResult] = useState();
  const handleOnChange = (res: string) => {
    setResult(res);
  };

  return <AuthCode onChange={handleOnChange} />;
};

Mode

By default you can type numbers and letters in the inputs as the allowedCharacters prop is defaulted to alphanumeric but you can also choose between allowing only letters or only numbers by setting the prop to alpha or numeric respectively.

import React, { useState } from 'react';
import AuthCode from 'react-auth-code-input';

const App = () => {
  const [result, setResult] = useState();
  const handleOnChange = (res: string) => {
    setResult(res);
  };

  return <AuthCode allowedCharacters='numeric' onChange={handleOnChange} />;
};

Focus

By default the first input is focused when the component is mounted, you can opt-out from this by setting the autoFocus prop to false, and then you can handle the focus manually by passing a reference.

import React, { useRef, useState } from 'react';
import AuthCode, { AuthCodeRef } from 'react-auth-code-input';

const App = () => {
  const AuthInputRef = useRef<AuthCodeRef>(null);
  const [result, setResult] = useState();
  const handleOnChange = (res: string) => {
    setResult(res);
  };

  return (
    <>
      <AuthCode
        autoFocus={false}
        onChange={handleOnChange}
        ref={AuthInputRef}
      />
      <button onClick={() => AuthInputRef.current?.focus()}>Focus</button>
    </>
  );
};

Clear

You can clear all the inputs by passing a reference and then calling the clear method.

import React, { useRef, useState } from 'react';
import AuthCode, { AuthCodeRef } from 'react-auth-code-input';

const App = () => {
  const AuthInputRef = useRef<AuthCodeRef>(null);
  const [result, setResult] = useState();
  const handleOnChange = (res: string) => {
    setResult(res);
  };

  return (
    <>
      <AuthCode onChange={handleOnChange} ref={AuthInputRef} />
      <button onClick={() => AuthInputRef.current?.clear()}>Clear</button>
    </>
  );
};

SMS Autofill

This component supports autofill from SMS's received, tested on Safari and Chrome in iOS.

Props

PropTypeDescriptionDefault ValueObservations
allowedCharactersStringType of allowed characters for your code.alphanumericValid values: alpha, alphanumeric, numeric
ariaLabelStringAccessibility.
autoFocusBooleanWether the first input is focused on mount or not..trueSince version 3.1.0
lengthNumberThe number of inputs to display.6
containerClassNameStringThe styles to be applied to the container.
inputClassNameStringThe styles to be applied to each input.
onChangeFunction(value: String)Callback function called every time an input value changes.Required
isPasswordBooleanWhether to display the inputs as passwords or not.false
disabledBooleanMakes all the inputs disabled if true.falseSince version 3.1.1
placeholderStringDisplays a placeholder in all the inputs.Since version 3.2.0

Changelog

3.2.0

  • Add placeholder prop.
  • Export component props.

3.1.0

  • Add disabled prop to disable all the inputs.
  • Make the backspace delete the previous character if the current is empty. Previously it just moved the focus making the user hit twice the backspace to delete the value.

3.1.0

  • Add autoFocus prop set to true by default to not break current usages.
  • Expose a focus method using references to handle the focus of the first input manually.
  • Expose a clear method using references to clear the input programmatically.
  • Add validations for when not using typescript.
  • Update React peerDependency to use any version 16+.

3.0.0

  • Change the way the allowed characters are handled by using 3 predefined modes: alpha, alphanumeric, and numeric, allowing to have more control when validating the values introduced in the inputs.
  • Improved logic.
  • Improved tests.
  • Improved types.

License

Licensed under the MIT License, Copyright © 2020-present Luis Guerrero drac94.

See LICENSE for more information.

Keywords

FAQs

Package last updated on 07 Jun 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc