react-native-otp-box
v1.0.24
Published
is a tiny JS library for one time passcode (OTP). Supports smart input suggestion on iOS and code autofill on Android (it will be filled when you press the copy button on the SMS notification bar)
Downloads
20
Maintainers
Readme
React Native OTP Input
@twotalltotems/react-native-otp-input is a tiny Javascript library which provides an elegant UI for the end user to input one time passcode (OTP). It handles the input suggestion on iOS when the OTP SMS is received. For Android, it will autofill when the user presses the copy button on the SMS notification bar. It also features a carefully crafted flow to handle edge cases for volatile user gestures. We provide default UI, but you can always customize the appearance as you like.
Installation
npm install --save @twotalltotems/react-native-otp-input
or
yarn add @twotalltotems/react-native-otp-input
Dependencies
It does not have additional dependencies except for React Native itself.
Basic Usage
import OTPInputView from '@twotalltotems/react-native-otp-input'
<OTPInputView
style={{width: '80%', height: 200}}
pinCount={4}
code=""
autoFocusOnLoad={true}
// codeInputFieldStyle={styles.borderStyleBase}
// codeInputHighlightStyle={styles.borderStyleHighLighted}
codeInputFieldStyle={styles.underlineStyleBase}
codeInputHighlightStyle={styles.underlineStyleHighLighted}
onCodeFilled = {(code => {
console.log(`Code is ${code}, you are good to go!`)
})}
/>
const styles = StyleSheet.create({
borderStyleBase: {
width: 30,
height: 45
},
borderStyleHighLighted: {
borderColor: "#03DAC6",
},
underlineStyleBase: {
width: 30,
height: 45,
borderWidth: 0,
borderBottomWidth: 1,
},
underlineStyleHighLighted: {
borderColor: "#03DAC6",
},
});
Parameters
| Parameter | required | Description | |-------------|----------|-------------| | pinCount | YES | Number of digits in the component | | code | NO | Besides providing an initial value, you can also enter this value using state or props. It will override the user input and reset the focus. For example, you can use it to hook up with the Android SMS Retriever API. | | codeInputFieldStyle | NO | The style of the input field which is NOT focused | | codeInputHighlightStyle | NO | The style of the input field which is focused | | autoFocusOnLoad | NO | Auto activate the input and bring up the keyboard when component is loaded | | onCodeFilled | NO | Callback when the last digit is entered |
Notes
The iOS input suggestion requires React Native 0.58+ and works for iOS 12 and above.
On Android, it will be auto filled when you press the copy code button in the notification bar (see above GIF). It will do so only if the code is sent after the view is loaded. So make sure you request the code AFTER this view is loaded.
If you are interested in Android SMS Retriever API, I would suggest @Faizal's repo React-Native-OTP-Verify. It looks pretty cool and it should be straight-forward to use React-Native-OTP-Verify along with this library.
RoadMap
- [ ] Typescript
- [ ] Add tests
Contributors
Premium Support By TTT Studios
Paginatable List is presented by the mobile team at TTT Studios. We are a Digital Innovation Studio based out of Vancouver, Canada, delivering custom software and solutions that are designed and developed 100% in-house. The technologies we work with include AR & VR, IoT, AI, security & encryption, and cloud computing.