Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

Split 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.

Show code
<app-auth-layout variant="Split">
    <app-auth-logo><img src="/logo.svg" alt="Acme" width="160" height="48" /></app-auth-logo>
    <h1>Sign in</h1>
    <p>Use your work email.</p>
    <app-button block="true">Continue</app-button>
    <app-auth-aside><p>Pay your team on time.</p></app-auth-aside>
    <app-auth-footer><p class="mb-0">Need help? Contact support.</p></app-auth-footer>
</app-auth-layout>

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.

Show code
<app-auth-layout>
    <app-auth-logo><img src="/logo.svg" alt="Acme" width="160" height="48" /></app-auth-logo>
    <h1>Sign in</h1>
    <p>Use your work email.</p>
    <app-button block="true">Continue</app-button>
    <app-auth-footer><p class="mb-0">Need help? Contact support.</p></app-auth-footer>
</app-auth-layout>

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.

centred split
sm md lg

Sign in

Use your work email.

React, generated from the controls
<AppAuthLayout>
  <h1>Sign in</h1>
  <p>Use your work email.</p>
  <AppButton block>Continue</AppButton>
</AppAuthLayout>
Razor, the same props
<app-auth-layout>
    <h1>Sign in</h1>
    <p>Use your work email.</p>
</app-auth-layout>

6 props. The 2 most used come first.

Used on most screens 2 props

PropTypeDefaultDescription
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

PropTypeDefaultDescription
<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.