API.md

• API documentation react-native-confirmation-code-field
  • Components
    • <CodeField />
      • cellCount?: number
      • renderCell: (options: {symbol: string, index: number, isFocused: boolean}) => ReactElement
      • RootComponent?: ComponentType<any>
      • InputComponent?: ComponentType<any>
      • rootStyle?: StyleProp<RootComponent>
      • RootProps?: Object
      • textInputStyle?: StyleProp<TextStyle>
    • <Cursor/>
  • Hooks
    • useClearByFocusCell({value?: string, setValue: (text: string) => void})
    • useBlurOnFulfill({value?: string, cellCount: number}): Ref<TextInput>

API documentation react-native-confirmation-code-field

Components

<CodeField />

This a base component that render RootComponent (default: View) with cells that would be returned by renderCell() and a <TextInput/> that will be invisible and over all cells within root component

JSX tree will be next:

<RootComponent style={rootStyle} {...RootProps}>
    {renderCell({index: 0,...})}
    {renderCell({index: 1,...})}
    // ...
    <TextInput style={[{opacity: 0},textInputStyle]} />
</RootComponent>

Inherits TextInput Props, (except style, use rootStyle for applying styles)

cellCount?: number

Number of characters in input (optional, default: 4)

renderCell: (options: {symbol: string, index: number, isFocused: boolean}) => ReactElement

Required function for Cell rendering, will be invoke with next options:

• symbol: string
• index: number
• isFocused: boolean

RootComponent?: ComponentType<any>

If you want change root component for example using animations RootComponent={Animated.View} (optional, default View)

InputComponent?: ComponentType<any>

If you want to provide a custom TextInput component that can receive the same props (optional, default TextInput)

rootStyle?: StyleProp<RootComponent>

Styles for root component (optional)

RootProps?: Object

Any props that will applied for root component <RootComponent style={rootStyle} {...RootProps} />

textInputStyle?: StyleProp<TextStyle>

Styles for invisible <TextInput/>, can be used for testing or debug (optional)

---

<Cursor/>

It's a help component for simulation a cursor blinking animation in <Cell/> components

import {Cursor} from 'react-native-confirmation-code-field';

<Cursor
  // Blinking animation speed (optional, number)
  delay={500}
  // Symbol that would be returned to simulate cursor blinking (optional, string)
  cursorSymbol="|"
/>;

---

Hooks

useClearByFocusCell({value?: string, setValue: (text: string) => void})

Simple hook that add functionality that trim value by pressed cell

After invoke this hook wil return array with two values [props,getCellOnLayout];

• props - an object that you should spreed to <CodeField/>
• getCellOnLayout(index: number): Function - helper method that returns onLayout handler

⚠️ ⚠️ ⚠️ If you need to style only one borderX (example borderBottom) you need to know about React Native issue with border styles for <Text/> on iOS.

To fix it need <View/> wrapper for Cell, but don't forger to move onLayout={getCellOnLayoutHandler(index) to <View/>:

// BAD 👎
renderCell={({index, symbol, isFocused}) => (
  <View key={index}>
    <Text
      onLayout={getCellOnLayoutHandler(index)}
    >
      {...}
    </Text>
  </View>
)}


// GOOD ✔️
renderCell={({index, symbol, isFocused}) => (
  <View
    key={index}
    onLayout={getCellOnLayoutHandler(index)}
  >
    <Text>{...}</Text>
  </View>
)}

Example:

import {
  CodeField,
  useClearByFocusCell,
} from 'react-native-confirmation-code-field';

const App = () => {
  const [codeFieldProps, getCellOnLayout] = useClearByFocusCell({
    value,
    setValue,
  });

  return (
    <CodeField
      {...codeFieldProps}
      value={value}
      onChangeText={setValue}
      renderCell={({index, symbol, isFocused}) => (
        <Text
          key={index}
          // Call getter method on each cell component
          onLayout={getCellOnLayout(index)}>
          {symbol}
        </Text>
      )}
    />
  );
};

useBlurOnFulfill({value?: string, cellCount: number}): Ref<TextInput>

This hook include a logic to blurring <TextInput/> when value fulfilled

You should pass two params:

• value?: string - a string value that
• cellCount: number

Returned value will be a TextInput ref that you should pass to <CodeField/> component.

And when a value length would equal cellCount will be called .blur() method.

It work perfectly with useClearByFocusCell hook.

import {
  CodeField,
  useBlurOnFulfill,
} from 'react-native-confirmation-code-field';

const App = () => {
  const CELL_COUNT = 4;
  const ref = useBlurOnFulfill({value, cellCount: CELL_COUNT});

  return (
    <CodeField
      ref={ref}
      value={value}
      cellCount={CELL_COUNT}
      //...
    />
  );
};