Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 217 Commits
.github		.github
example		example
src		src
.all-contributorsrc		.all-contributorsrc
.babelrc.json		.babelrc.json
.eslintignore		.eslintignore
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.npmignore		.npmignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
LICENSE		LICENSE
README.md		README.md
package.json		package.json
rollup.config.js		rollup.config.js
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

Repository files navigation

react-otp-input

A fully customizable, one-time password input component for the web built with React.

Live Demo

Installation

To install the latest stable version:

npm install --save react-otp-input

Still using v2?

No problem! You can find the documentation for v2here

Basic usage:

importReact,{useState}from'react';importOtpInputfrom'react-otp-input';exportdefaultfunctionApp(){const[otp,setOtp]=useState('');return(<OtpInputvalue={otp}onChange={setOtp}numInputs={4}renderSeparator={<span>-</span>}renderInput={(props)=><input{...props}/>}/>);}

API

You can also pass a function that returns a component, where the function will get the index of the separator being rendered as an argument.

Name	Type	Required	Default	Description
numInputs	number	true	4	Number of OTP inputs to be rendered.
renderInput	function	true	none	A function that returns the input that is supposed to be rendered for each of the input fields. The function will get two arguments:`inputProps` and`index`.`inputProps` is an object that contains all the propsthat should be passed to the input being rendered (Overriding these props is not recommended because it might lead to some unexpected behaviour).`index` is the index of the input being rendered.
onChange	function	true	console.log	Returns OTP code typed in inputs.
onPaste	function	false	none	Provide a custom onPaste event handler scoped to the OTP inputs container. Executes when content is pasted into any OTP field. Example: const handlePaste: React.ClipboardEventHandler = (event) => { const data = event.clipboardData.getData('text'); console.log(data)};
value	string / number	true	''	The value of the OTP passed into the component.
placeholder	string	false	none	Specify an expected value of each input. The length of this string should be equal to`numInputs`.
renderSeparator	component / function	false	none	Provide a custom separator between inputs by passing a component. For instance,`<span>-</span>` would add`-` between each input.
containerStyle	style (object) / className (string)	false	none	Style applied or class passed to container of inputs.
inputStyle	style (object) / className (string)	false	none	Style applied or class passed to each input.
inputType	<input> type	false	text	The type of the input that will be passed to the input element being rendered. In v2`isInputNum` used to set the input type as`tel` and prevented non numerical entries, so as to avoid the spin buttons added to the inputs with input type`number`. That behaviour is still supported if you pass`tel` to the inputType prop.
shouldAutoFocus	boolean	false	false	Auto focuses input on initial page load.
skipDefaultStyles	boolean	false	false	The component comes with default styles for legacy reasons. Pass`true` to skip those styles. This prop will be removed in the next major release.

⚠️ Warning

Do not override the following props on the input component that you return from therenderInput prop. Doing so might lead to unexpected behaviour.

ref
value
onChange
onFocus
onBlur
onKeyDown
onPaste
onInput
type
inputMode

Migrating from v2

The v3 ofreact-otp-input is a complete rewrite of the library. Apart from making the API more customizable and flexible, this version is a complete rewrite of the library using TypeScript and React Hooks. Here are the breaking changes that you need to be aware of:

You now need to pass your own custom input component that will be rendered for each of the input fields viarenderInput prop. This gives you the flexibility to customize the input fields as you desire. This also means that props likefocusStyle,isDisabled,disabledStyle,hasErrored,errorStyle,isInputNum,isInputSecure,data-cy anddata-testid are no longer supported. You can achieve the same functionality and more by passing the relevant props directly to the input component that you return from therenderInput prop.
Theseparator prop has now been renamed torenderSeparator. This prop now apart from accepting a component that will be rendered as a separator between inputs like it used to, now also accepts a function that returns a component. The function will get the index of the separator being rendered as an argument.
A new prop calledinputType has been added to the component. This prop can be used to specify the type of the input that will be passed to the input element being rendered. The default value of this prop isnumber.

Migrating from v1

react-otp-input is now a controlled component to facilitate functionalities that weren't possible before from the application using it, such as clearing or pre-assigning values. Forv1.0.0 and above, avalue prop needs to be passed in the component for it to function as expected.

Development

To run the vite example:

cd examplenpm run dev

Checklist

Write tests
Add actions for lint checks and tests

Contributing

Feel free to openissues andpull requests!

License

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Abhishek Warokar} 💻🎨🚧🤔👀	_Aj 💻🎨🤔	_{Aromal Anil} 💻🔧	_{Gabriele Corti} 💻️️️️♿️	_Anoop 💻	_{Dewansh Rawat} 🐛	_{Ishan Chhabra} 💻
_yaojie 💻	_{Prateek Surana} 💻🚧🤔📖🎨	_{Süleyman Barış Eser} 🐛	_{Steve Domino} 💻	_{Stephen Hogan} 💻