On this page
@addTagHelper *, Webority.Ui.RazorBasic
Each value takes a label and a value; the note is optional and sits under the number.
Columns
Three to five values sit in a row; below 768px the strip shows two columns, whatever the count.
Size
Use sm under a dense page header; md is the default for a strip in the page body.
Divided
Inside a flush card the figures form one row with a rule between them from md up. Below md they stay two to a row with no rules.
Tone
The tone tints the value only, so use it for a number that is good or bad news, not decoration.
Links
A value with href is a link to the list behind it, and hover underlines the number.
Every option
Every value of every prop, one cell each.
columns: 3, 4, 5
columns="3"
(default) columns="4"
columns="5"
size: md, sm
(default) size="md"
size="sm"
tone: neutral, success, warning, danger, info
tone="neutral"
tone="success"
tone="warning"
tone="danger"
tone="info"
href: makes the value a link
href="/Components/AppMetricStrip"
label, value and note: text
label="Sprint 5"
value="18 of 41 done"
note="6 days left"
items: the values
items={[{ label, value, note, href, tone }]} in React, app-metric children here
linkComponent: React only
linkComponent: React only, Razor keeps the plain href
className: React only
className: React only, Razor has no equivalent
Guidance
What to do, and what to avoid.
Use it when
- A page opens with three to five headline numbers.
- Each number links to the list or report behind it.
- The numbers need no surface of their own.
Reach for something else when
- One number needs its own card and icon. → AppKpiTile
- The facts are a record's details. → AppDescriptions
- You are listing many records. → AppDataTable
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
8 props. The 3 most used come first.
Used on most screens 3 props
| Prop | Type | Default | Description |
|---|---|---|---|
| columnsdefault 4 | 3 | 4 | 5 | 4 | How many values sit in a row. |
| sizedefault md | sm | md | md | The value and label scale. |
| divideddefault false | bool | false | Draws the strip as one flush row with a rule between figures from md up, for a strip inside a flush card. |
Less common 5 props
| Prop | Type | Default | Description |
|---|---|---|---|
| labeldefault - | string | - | The label above the value. |
| valuedefault - | string | - | The value itself, already formatted. |
| notedefault - | string | - | A short line under the value. |
| hrefdefault - | string | - | Makes the value a link to this URL. |
| tonedefault neutral | neutral | success | warning | danger | info | neutral | Tints the value. |
Screen reader
2 notes- An item with an href is a real link; an item without one is plain text, so nothing is announced as a link that goes nowhere.
- Label, value and note are plain text in reading order, with no hidden content.