On this page
@addTagHelper *, Webority.Ui.RazorA dock of links
Items are the row, left to right, and each needs a title that is both its name and its tooltip.
Tuning the magnification
Max scale sets the size under the pointer and radius sets how far the effect reaches along the row.
Static dock
Turn magnification off for a plain pill row that does not react to the pointer.
Empty dock
A dock with no items shows no links.
no app-dock-item children: empty dock
No items means no links in the dock.
Router-decoupled links
Razor has no router, so every item takes href and there is no linkComponent or to.
Every option
Every value of every prop, one cell each.
magnify
maxScale: item size at cursor centre
radius: px falloff distance
item shapes
no href: renders <button> (React: onClick, no href or to)
linkComponent
ariaLabel and edge cases
no app-dock-item children: empty dock
className
Guidance
What to do, and what to avoid.
Use it when
- A marketing or landing surface wants a playful shortcut row, such as a hero, footer or portfolio.
- The set is small (4 to 8 items) and every item reduces to one clear icon and title.
- The destinations are also reachable through normal navigation.
Reach for something else when
- You need the app's persistent primary navigation. → AppShell
- The actions belong to a toolbar or a data row. → AppActionIcon
- You want a path or hierarchy trail, not shortcuts. → AppBreadcrumbs
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
5 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| aria-labeldefault Quick navigation | string | Quick navigation | Accessible name for the dock landmark. |
| magnifydefault true | bool | true | Set false to render a static dock, with no hover effect. |
| max-scaledefault 1.6 | decimal | 1.6 | Item scale at the cursor's centre. The element default is 1.6. |
| radiusdefault 100 | decimal | 100 | Falloff distance for the magnification, in pixels. The element default is 100. |
Less common 1 props
| Prop | Type | Default | Description |
|---|---|---|---|
| classdefault - | string | - | Extra classes on the dock; passes through as a plain HTML attribute (no dedicated tag helper property). |
Screen reader
3 notes- The dock is a navigation landmark named by ariaLabel.
- Every item is a real link or button named by its title; the visible tooltip is hidden from assistive technology.
- Magnification turns itself off on touch pointers and when the person prefers reduced motion, leaving a plain icon row.