On this page
@addTagHelper *, Webority.Ui.RazorA person
Use a preview on a name in running text, so the person's details show without a click.
Name in a sentence
a person's name inside a sentence opens a card with their job title and join date.
Assigned to
Fetched content
Use a spinner while the preview loads, and start the fetch when the card opens.
Every option
Every value of every prop, one cell each.
trigger
trigger: a link, the name the card belongs tochildren
children: any layout, shown when it opensINV-2041₹1,24,500 due 14-Nov-2026
label
label="Asha Verma, profile": the accessible name, not shownloading
(default, loading off)loading="true": spinner in place of the content while fetchingloadingLabel
loading-label="Loading" (default)loading-label="Fetching the invoice": beside the spinner while loadingopenDelay
open-delay="0"open-delay="300" (default)open-delay="1000"closeDelay
close-delay="0"close-delay="150" (default)close-delay="1000"open
(default, closed)open="true": shows the panel without a hoveronOpenChange
onOpenChange, or the wui:hover-card:open and wui:hover-card:close events: called on open and close, no visible changeclassName
className, or class="demo-card": adds classes to the root element, no visible changeGuidance
What to do, and what to avoid.
Use it when
- A name or record link that people check in passing.
- A short summary that can be fetched on demand.
Reach for something else when
- Actions or a form that opens on click. → AppPopover
- One line of help text. → AppTooltip
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
8 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| labeldefault - | string | - | The card's accessible name, for example Asha Verma, profile. |
| loadingdefault false | bool | false | Shows a spinner and the loading label in place of the content while the preview is fetched; start the fetch when the card opens. |
| open-delaydefault 300 | int | 300 | Milliseconds of hover or focus before it opens. |
| opendefault false | bool | false | Shows the panel open, for a design preview or a controlled caller. |
Less common 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| (trigger)default - | markup | - | The name or link the card belongs to, passed in the trigger slot. Make it a link so keyboard users can focus it. |
| (content)default - | markup | - | The card's content, any layout, passed in the content slot. |
| loading-labeldefault Loading | string | Loading | The text beside the spinner. |
| close-delaydefault 150 | int | 150 | Milliseconds after leaving before it closes. |
Screen reader
3 notes- The panel has role group, named by the label prop when given, and aria-busy while it loads; the loading text sits in a role status region.
- The card opens when the trigger takes keyboard focus as well as on hover, and Escape closes it.
- Touch never opens it, so the trigger must itself lead to the same information, for example a link to the record.