On this page
@addTagHelper *, Webority.Ui.RazorIn a real screen
A settings form as a product builds it: two sections, required fields, validation on Save and an action bar.
Group related fields
Wrap a set of related fields in a section with a heading and an optional description, so a form reads in parts.
Contact Information
Billing Address
Where you want invoices sent
Layout, labels and density
Use the side layout on settings pages with several sections, labels beside fields on wide admin forms, and compact density for dialogs.
Notifications
Account
Filters
Notifications
Company profile
Contact Information
Composing a complete form
Combine sections, rows and actions to build a standard form, with the actions footer at the end.
Personal Details
Contact
Every option
Every value of every prop, one cell each.
children
childrentitle and description
(no title, no description)title onlyPreferences
description onlyA description renders on its own too
title + descriptionPreferences
Control how you are notified
layout
layout="stacked" (default)Profile
Your public details.
layout="side"Profile
Your public details.
labels
labels="top" (default)Profile
Your public details.
labels="start"Profile
Your public details.
density
density="comfortable" (default)Profile
Your public details.
density="compact"Profile
Your public details.
title-font
title-font="body" (default)Profile
Your public details.
title-font="display"Profile
Your public details.
title-size
title-size (default): unset, the theme's 15pxProfile
Your public details.
title-size="20"Profile
Your public details.
rule
rule="line" (default)Profile
Contact
rule="none"Profile
Contact
heading-level
heading-level="2"Profile
Your public details.
heading-level="3" (default)Profile
Your public details.
heading-level="4"Profile
Your public details.
class
class: adds classes to the root elementProfile
Guidance
What to do, and what to avoid.
Use it when
- You're building a form page: use all three helpers together for a consistent layout.
- You need to group logically related fields: AppFormSection wraps them with a title.
- You have multiple fields in a row: AppFormRow arranges them responsively.
- You're adding action buttons (submit, cancel, etc.): AppFormActions keeps them aligned.
Reach for something else when
- You're placing a single isolated field → just use AppInput directly
- Your form is a dialog/modal → AppModal / AppConfirmDialog owns the footer logic
- You need a custom grid layout → use Bootstrap Row/Col for full control
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
9 props. The 5 most used come first.
Used on most screens 5 props
| Prop | Type | Default | Description |
|---|---|---|---|
| titledefault - | string | - | Section heading, at the level heading-level sets (h3 by default). |
| descriptiondefault - | string | - | Intro text under the title. Renders on its own when there is no title. |
| layoutdefault stacked | stacked | side | stacked | side puts the title and description in a column beside the fields from lg up; below that it stacks. |
| labelsdefault top | top | start | top | start puts each field's label beside its control (one field per row) from md up; below that labels sit on top. |
| densitydefault comfortable | comfortable | compact | comfortable | compact uses 32px controls and tighter gaps, for admin screens and dialogs. |
Less common 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| heading-leveldefault 3 | 2 | 3 | 4 | 3 | Heading level of the section title, so it nests under the page or drawer heading. |
| title-fontdefault body | body | display | body | display sets the title in the display face; body keeps the text face. |
| title-sizedefault 15 | number | 15 | The title's font size in px; unset keeps the theme's 15px. |
| ruledefault line | line | none | line | none drops the hairline between consecutive sections and keeps the space. |
Screen reader
3 notes- Renders a section element whose title is a real heading: h3 by default, h2 to h4 through headingLevel, so it appears in the page outline.
- The description is a paragraph under the heading; the heading and description are left out when neither title nor description is given.
- Extra attributes such as aria-labelledby pass through to the section.