Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

A dock of links

Items are the row, left to right, and each needs a title that is both its name and its tooltip.

Hover across the row
The item under the pointer grows and its neighbours taper off.
Show code
<app-floating-dock>
    <app-dock-item icon="house" title="Home" href="/" />
    <app-dock-item icon="box-seam" title="Products" href="/products" />
    <app-dock-item icon="tag" title="Pricing" href="/pricing" />
    <app-dock-item icon="file-text" title="Docs" href="/docs" />
    <app-dock-item icon="mail" title="Contact" href="/contact" />
</app-floating-dock>

Tuning the magnification

Max scale sets the size under the pointer and radius sets how far the effect reaches along the row.

Bigger, wider
A dock with a larger max scale and a wider radius.
Show code
<app-floating-dock max-scale="2" radius="140">…</app-floating-dock>

Static dock

Turn magnification off for a plain pill row that does not react to the pointer.

Static, no magnification
The same pill row with the effect off.
Show code
<app-floating-dock magnify="false">…</app-floating-dock>

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.
Show code
<app-floating-dock></app-floating-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

magnify (default, true)

maxScale: item size at cursor centre

radius: px falloff distance

item shapes

href: real link (default)
to (React only): Razor items use href
no href: renders <button> (React: onClick, no href or to)
icon as a custom node (React only): Razor takes a library icon name

linkComponent

linkComponent (React only): Razor has no router, so items use href

ariaLabel and edge cases

aria-label="Site shortcuts"
no app-dock-item children: empty dock
magnify="false": the touch and prefers-reduced-motion fallback the element applies itself

className

class="demo-extra": extra classes on the dock, no look of its own

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.

React, generated from the controls
<AppFloatingDock
  items={items}
/>
Razor, the same props
<app-floating-dock>…</app-floating-dock>

5 props. The 4 most used come first.

Used on most screens 4 props

PropTypeDefaultDescription
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

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