Skip to content

AuthorizingForm ​

Overview ​

Authentication wrapper that monitors login state and redirects the user after a successful sign-in, rendering a header, subtitle, and delegating to ActionForm for the actual credential form.

Theme entry: AuthorizingForm

Props ​

NameTypeRequiredDefaultDescription
themeOverrideObjectnullA partial ThemeObject keyed by component name, merged over this component's theme and provided to descendants.
redirectstring|objectundefinedVue Router location to push to after a successful login; falls back to { name: "welcome" } or the ?redirect query param.
headerstring""Heading text rendered above the form.
subTitlestring""Subtitle text rendered below the heading.
runActionfuncundefinedAction function forwarded to the inner ActionForm.
formPropsobject{}Props passed to useForm to configure the form context.
permittedbooleantrueWhen false, the form is hidden and the invalid-message slot is shown instead.
requireRecentLoginbooleanfalseWhen true, the post-login redirect only triggers if the user has also recently authenticated (re-auth guard).
toastsobjectundefinedToast text for the post-login redirect: success once it arrives, redirectFailed when it does not. Each entry is { title, description } and replaces the matching sign-in default, field by field.
onSubmissionSuccessHandlerfuncundefinedCalled with the response after a successful submission, in place of the default, which shows nothing because the sign-in redirect announces itself.

Slots ​

NameScopedDescription
action-baryes
confirm-buttonyes
cancel-buttonyes
actions-hint
validation-summaryyesOverride the structured per-field validation alert shown when formContext.state.anyError is set and at least one field error has no rendered field showing it; receives entries (each { field, label, messages }, limited to those errors), count, and title.
action-form-inneryes
form-confirm-dialog-warningsyes
auth-form-prefix-header
auth-form-inneryes
headeryes
contentyes
suffix
invalid-message

Full slot reference

Events ​

NameDescription
form-objectEmitted on mount with a readonly ref to the reactive form values object.
form-contextEmitted on mount with the form context. Use its methods for programmatic form updates.

Full event reference

Source ​

client/lib/views/AuthorizingForm.vue