On this page
@addTagHelper *, Webority.Ui.RazorSplit with an aside
The split page puts the form in one column and a pitch or reassurance in the aside beside it.
Split layout with a logo, an aside and a footer
The aside holds the product's pitch or a reassurance; the form stays in the children.
Sign in
Use your work email.
Centred form
Without a split the form sits alone in the middle of the page, which suits most sign-in and reset pages.
Centred sign-in form
Sign in
Use your work email.
Every option
Every value of every prop, one cell each.
variant: both
variant="centred" (default)
Sign in
Use your work email.
variant="split"
Sign in
Use your work email.
maxWidth: presets and a number
max-width="sm"
Sign in
Use your work email.
max-width="md" (default)
Sign in
Use your work email.
max-width="lg"
Sign in
Use your work email.
max-width="480"
Sign in
Use your work email.
logo: any node
<app-auth-logo>
Sign in
Use your work email.
aside: any node, drawn for split
<app-auth-aside> (with variant="split")
Sign in
Use your work email.
footer: any node
<app-auth-footer>
Sign in
Use your work email.
className: extra classes
class="…" (adds extra classes to the root, no visible change here)
Sign in
Use your work email.
Guidance
What to do, and what to avoid.
Use it when
- A sign-in, sign-up, forgot-password or verification page.
- Any signed-out page that is one form on its own.
Reach for something else when
- A short outcome after an action (confirmed, not found, no access). → AppResult
- The boot screen while the session loads. → AppSplash
- A form inside a signed-in page. → AppCard
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
6 props. The 2 most used come first.
Used on most screens 2 props
| Prop | Type | Default | Description |
|---|---|---|---|
| variantdefault centred | centred | split | centred | The form alone in the middle, or the form beside an aside panel. |
| max-widthdefault md | sm | md | lg | number | md | The widest size of the form column: a preset or an exact width in px. The presets are 360, 420 and 520 px. |
Less common 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| <app-auth-logo>default - | child | - | The brand mark above the form. Drawn only when present. |
| <app-auth-aside>default - | child | - | Content beside the form. Drawn only when the variant is split. |
| <app-auth-footer>default - | child | - | A line under the form, such as a help link. Drawn only when present. |
| classdefault - | string | - | Extra classes on the root element. |
Screen reader
3 notes- The layout draws no heading: put the one h1 of the page in the children.
- The aside is an aside landmark and is hidden below the lg breakpoint, so nothing in it may be the only way to do something.
- The logo is an image the caller labels with alt text; use an empty alt if the heading already names the product.