Comment on page
Common Screen Props
These are optional props shared by both screen components.
These props are customizations that are the same for
AuthFlow, AuthFlow.ConfirmScreen, andAuthFlow.PhoneScreen. They can also be used in withPhoneAuth's second argument.These props are mainly ways to style your screens and such.
The props below are all optional.
type CommonScreenProps = {
/**
* Default: `left`.
*
* Set to `center` if you want the screen text and input to be centered by default.
*/
textAlign?: TextStyle['textAlign']
/**
* The default text color. If you want more granular customization, see `titleColor`, `disclaimerColor` and `messageColor`.
*
* Default: `white`
*/
textColor?: TextStyle['color']
/**
* Background color for the header at the top of the screen.
*
* Default: `transparent`.
*
* If you want a lot of customization, see the `renderHeader` prop.
*/
headerBackgroundColor?: string
/**
* Optionally render a custom component in place of the header title. This useful if you want to render your logo, for instance.
*/
renderHeaderTitle?: () => ReactNode
/**
* Optional custom color for the text and back icon in the header. If not set, it defaults to the value you set for the `textColor` prop.
*/
headerTintColor?: string
/**
* (Optional) custom props to be passed to the header.
*
* See the `react-native-elements` docs for the `Header` props: https://react-native-elements.github.io/react-native-elements/docs/header.html
*/
headerProps?: ComponentPropsWithoutRef<typeof Header>
/**
* Custom styles for the title in the header.
*
* If you just want to edit the text color, see `headerTintColor`.
*/
headerTitleStyle?: TextStyle
/**
* Either a string or array of strings.
*
* If an array is passed, it will render a gradient.
*
* Make sure to memoize this prop if you're using a gradient using `useMemo`.
* Or, place the array outside of the component code.
*
* @example
* ```es6
* export default () => {
* const backgroundColor = useMemo(() => ['blue', 'green' ],[])
* return <Phone.Stack backgroundColor={backgroundColor} {...otherProps} />
* }
* ```
*/
backgroundColor?: string | string[]
/**
* A function that returns a custom component that will replace the default background.
*
* This View should have the `StyleSheet.absoluteFill` in its styles so that it covers the entire screen.
*/
renderBackground?: () => ReactNode
/**
* Background color for the text input
*/
inputBackgroundColor?: string
/**
* Text color for the text input
*/
inputTextColor?: string
/**
* Define which premade style type for the input you would like.
*
* `elevated` has dropshadow and a colored background that contrasts with the screen background.
* `flat` has a transparent background and is more subtle.
*/
inputType?: 'elevated' | 'flat'
/**
* Optional function that renders a custom header. If `null`, will not return a header.
*
* Receives one argument: a dictionary with a `screen` field, which can be `code` or `phone`. This tells you which screen the header is currently on.
*
* @param info.screen - 'code' or 'phone', indicating which screen the header is currently being rendered on.
*/
renderHeader?: null | ((screen: { screen: 'code' | 'phone' }) => ReactNode)
/**
* (Optional) Style the view that contains the text input.
*/
inputContainerStyle?: ViewStyle
}
Last modified 3yr ago