Skip to content

SiLoginBasicComponent documentation

selector
si-login-basic

A basic login component that supports both single-step and two-step authentication flows.

This component provides a standard login form with username and password fields. It can be configured to work in two-step mode where username validation happens first, followed by password entry.

Example:

<si-login-basic
  [forgotPasswordLink]="forgotPasswordLink"
  [registerNowLink]="registerNowLink"
  [twoStep]="true"
  [loading]="isLoading"
  (login)="handleLogin($event)"
  (usernameValidation)="handleUsernameValidation($event)">
</si-login-basic>

Input Properties

Name Type Default Description
backButtonLabel
TranslatableString $localize`:@@SI_LOGIN_BASIC.BACK:Back` Description of back button.
disableLogin
boolean false Disables the login button.
Link Config for Forgot Password link. If title is omitted, a default translated label is used.
loading
boolean false Indicates whether the login button should show a loading state.
loginButtonLabel
TranslatableString $localize`:@@SI_LOGIN_BASIC.LOGIN:Log in` Label for login button.
nextButtonLabel
TranslatableString $localize`:@@SI_LOGIN_BASIC.NEXT:Next` Description of next button.
passwordLabel
TranslatableString $localize`:@@SI_LOGIN_BASIC.PASSWORD:Password` Label for password input field.
Link Config for Register Now link. If title is omitted, a default translated label is used.
twoStep
boolean false Enables the two-step login flow.
usernameLabel
TranslatableString $localize`:@@SI_LOGIN_BASIC.USERNAME:Username` Label for username input field.

Output Properties

Name Type Description
login
UsernamePassword Emits username and password on login event.
usernameValidation
UsernameValidationPayload Emits username when user clicks on next button.
valueChanged
UsernamePassword Emits username and password on value change.

Types Documentation

Represents a translatable string. This can either be a translation key, e.g. ACTIONS.EDIT that will be automatically translated when displayed on the UI or a pre-translated string, e.g. Edit . Equivalent to a normal string in usage and functionality.
Properties
password: (string | null | undefined)
username: (string | null | undefined)
(Pick<UsernamePassword, "username"> & { validate: (isValid: boolean) => void })

Except where otherwise noted, content on this site is licensed under MIT License.