Options
All
  • Public
  • Public/Protected
  • All
Menu

A form for logging in to AWS Cognito through Amplify.

On successful registration the ICognitoLoginProps.onRegisteredUser event is triggered.

On successful login the ICognitoLoginProps.onLoggedIn event is triggered.

Children can be supplied for the this component as well as child components. See ICognitoLoginProps.

Active form can be controlled using ICognitoLoginProps.activeForm prop.

Remarks:

  • Requires Amplify to be configured:

https://aws-amplify.github.io/docs/js/start?ref=amplify-rn-btn&platform=react-native#step-4-integrate-aws-resources

Props are ICognitoLoginProps

example
Initial form and callback { Alert.alert('Registration complete', 'Thank you ' + user.getUsername()); }} onLoggedIn={(user) => { Alert.alert('Logged in', 'Welcome ' + user.getUsername()); }}> Custom layouts here
example
With custom button props and callback { Alert.alert('Registration complete', 'Thank you ' + user.getUsername()); }} onLoggedIn={(user) => { Alert.alert('Logged in', 'Welcome ' + user.getUsername()); }} buttonProps={{mode: 'contained'}}> Custom layouts here
example
With custom children <ENLIST NOW> } > <WARNING: RESTRICTED AREA> :)

Type parameters

  • SS

Hierarchy

Index

Constructors

constructor

Properties

context

context: any

If using the new style context, re-declare this in your class to be the React.ContextType of your static contextType.

static contextType = MyContext
context!: React.ContextType<typeof MyContext>
deprecated

if used without a type annotation, or without static contextType

see

https://reactjs.org/docs/legacy-context.html

props

props: Readonly<object> & Readonly<ICognitoLoginProps>

refs

refs: object

Type declaration

  • [key: string]: ReactInstance

state

state: Readonly<ICognitoLoginState>

Static Optional contextType

contextType: Context<any>

If set, this.context will be set at runtime to the current value of the given Context.

Usage:

type MyContext = number
const Ctx = React.createContext<MyContext>(0)

class Foo extends React.Component {
  static contextType = Ctx
  context!: React.ContextType<typeof Ctx>
  render () {
    return <>My context's value: {this.context}</>;
  }
}
see

https://reactjs.org/docs/context.html#classcontexttype

Methods

ForgotPasswordAsync

  • ForgotPasswordAsync(email: string): Promise<void>

OnResendSignup

  • OnResendSignup(): void

OnResetPassword

  • OnResetPassword(): void

Optional UNSAFE_componentWillMount

  • UNSAFE_componentWillMount(): void

Optional UNSAFE_componentWillReceiveProps

  • UNSAFE_componentWillReceiveProps(nextProps: Readonly<ICognitoLoginProps>, nextContext: any): void

Optional UNSAFE_componentWillUpdate

Optional componentDidCatch

  • componentDidCatch(error: Error, errorInfo: ErrorInfo): void
  • Catches exceptions generated in descendant components. Unhandled exceptions will cause the entire component tree to unmount.

    Parameters

    • error: Error
    • errorInfo: ErrorInfo

    Returns void

Optional componentDidMount

  • componentDidMount(): void
  • Called immediately after a component is mounted. Setting state here will trigger re-rendering.

    Returns void

Optional componentDidUpdate

  • Called immediately after updating occurs. Not called for the initial render.

    The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.

    Parameters

    Returns void

Optional componentWillMount

  • componentWillMount(): void

Optional componentWillReceiveProps

  • componentWillReceiveProps(nextProps: Readonly<ICognitoLoginProps>, nextContext: any): void

Optional componentWillUnmount

  • componentWillUnmount(): void
  • Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as cancelled network requests, or cleaning up any DOM elements created in componentDidMount.

    Returns void

Optional componentWillUpdate

forceUpdate

  • forceUpdate(callBack?: undefined | function): void
  • Parameters

    • Optional callBack: undefined | function

    Returns void

Optional getSnapshotBeforeUpdate

  • Runs before React applies the result of render to the document, and returns an object to be given to componentDidUpdate. Useful for saving things such as scroll position before render causes changes to it.

    Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated lifecycle events from running.

    Parameters

    Returns SS | null

onConfirmAccount

  • onConfirmAccount(): Promise<void>

onConfirmMFACode

  • onConfirmMFACode(): Promise<void>

onEmailChanged

  • onEmailChanged(email: string | undefined): void

onLogin

  • onLogin(): Promise<void>

onPasswordChanged

  • onPasswordChanged(password: string | undefined): void

onPhoneChanged

  • onPhoneChanged(phone: string | undefined): void

onRegister

  • onRegister(): Promise<void>

onResultChanged

  • onResultChanged(): void

onSaveNewPassword

  • onSaveNewPassword(): Promise<void>

render

  • render(): Element

setState

  • setState<K>(state: function | null | S | object, callback?: undefined | function): void
  • Type parameters

    • K: keyof ICognitoLoginState

    Parameters

    • state: function | null | S | object
    • Optional callback: undefined | function

    Returns void

Optional shouldComponentUpdate

  • Called to determine whether the change in props and state should trigger a re-render.

    Component always returns true. PureComponent implements a shallow comparison on props and state and returns true if any props or states have changed.

    If false is returned, Component#render, componentWillUpdate and componentDidUpdate will not be called.

    Parameters

    Returns boolean

Static getDerivedStateFromProps

Object literals

ForgotPasswordAlertButton

ForgotPasswordAlertButton: object

text

text: string = "OK"

onPress

  • onPress(): Promise<void>

cancelAlertButton

cancelAlertButton: object

style

style: "cancel" = "cancel"

text

text: string = "Cancel"

onPress

  • onPress(): void