---
title: "ResultCard"
description: "One test result, shown in full. What was measured, the number, where it sits against its range, what that means in plain English, and what to do next."
url: "https://opsinjs.pensievelabs.org/docs/components/result-card"
source: "https://opsinjs.pensievelabs.org/docs/components/result-card.md"
section: "Components"
status: "shipped"
kind: "component"
category: "health-data-display"
reviewed: "2026-09-20"
reviewer: "engineering"
aliases: ["results", "lab result", "test result", "report card", "blood pressure", "a1c"]
governedBy: ["two-colour-axes", "reference-ranges", "numbers", "trends", "high-stakes-moments", "consent-and-privacy", "safety-review"]
usedIn: ["result-disclosure"]
implemented: true
---

> Elements written as `<PascalCase … />` below are opsinjs documentation
> components. Their attributes are the content: the values they render are
> generated from `tokens/*.json` and `registry/catalogue.ts` and are
> published separately at https://opsinjs.pensievelabs.org/r/index.json and under the Reference
> section.
> `<StubNotice>` IS THE EXCEPTION, AND IT IS THE ONE TO READ. It is a
> paired element rather than a self-closing one, and the text between
> its opening and closing tags is prose an author wrote, reproduced
> below word for word. That prose is where this page says whether the
> component has been reviewed. Read the children, not only the
> attributes.

<StubNotice
  name="result-card"
  status="shipped"
  questions="[
  &#x22;The accessible name is the title alone, not title plus reading, and nobody has listened to whether that is enough.&#x22;,
  &#x22;No contrast pair, hit area, printout or screen-reader pass has been measured on this card.&#x22;,
  &#x22;The not-medical-advice note is not on this card, and whether products will place it is open.&#x22;,
]"
>
  Audited against WCAG 2.2 AA. Clinical review pending.
</StubNotice>

## Usage [#usage]

<ComponentInstall name="result-card" unbuilt="false" importPath="@/components/ui/result-card" registryDependencies="[&#x22;status-pill&#x22;, &#x22;value&#x22;, &#x22;range-bar&#x22;, &#x22;relative-time&#x22;, &#x22;button&#x22;]" />

```tsx
import { ResultCard } from "@/components/ui/result-card"
import { EXAMPLE_SOURCE } from "@/lib/opsinjs"
```

```tsx
<ResultCard
  title="Example measurement"
  value={14}
  unit="mg/dL"
  precision={0}
  measuredAt="2026-03-14T08:12:00+00:00"
  now="2026-03-14T11:12:00+00:00"
  range={{ low: 10, high: 20, source: EXAMPLE_SOURCE }}
  status="steady"
  category="labs"
  meaning="Two or three short sentences, in the second person, written by the product."
/>
```

## Examples [#examples]

<ComponentPreview name="result-card" />

### A reading made of two numbers [#a-reading-made-of-two-numbers]

`segments` carries a compound reading, each part a real [Value](./value.mdx).
The unit prints once, is spoken after every part, and no bar is drawn.

<ComponentPreview name="result-card-a-compound-reading" kind="example" align="start" />

### The smallest card, and the sentence it will not leave out [#the-smallest-card-and-the-sentence-it-will-not-leave-out]

No `range`, so no bar; no `status`, so no pill; no `provenance`, so no footnote.
An absent `meaning` still renders a sentence saying there is none.

<ComponentPreview name="result-card-no-explanation-supplied" kind="example" align="start" />

### The same result at two ages [#the-same-result-at-two-ages]

Two cards differ only in `measuredAt` and share a level, because age lowers a
reading's worth without raising the alarm.

<ComponentPreview name="result-card-an-old-reading" kind="example" align="start" />

## When to use it [#when-to-use-it]

<WhenToUse
  use="[
  &#x22;A single result with room for its range, meaning and next step, behind authentication.&#x22;,
  &#x22;A result seen for the first time, where the explanation matters as much as the number.&#x22;,
]"
  avoid="[
  { case: &#x22;Several readings side by side in a dashboard grid.&#x22;, instead: &#x22;metric-tile&#x22; },
  { case: &#x22;The number has no range, no status and nothing to explain.&#x22;, instead: &#x22;value&#x22; },
  { case: &#x22;You only need to show where a value sits within its range.&#x22;, instead: &#x22;range-bar&#x22; },
  { case: &#x22;The main message is an instruction rather than a measurement.&#x22;, instead: &#x22;care-card&#x22; },
  { case: &#x22;Something has changed and must interrupt the reader now.&#x22;, instead: &#x22;alert-banner&#x22; },
]"
/>

## Clinical meaning [#clinical-meaning]

**Asserts.** A measurement was taken, at a time, in a unit, with any stated range and
the level the product assigned.
[Every number](../health/numbers.mdx) goes through Value.

**Never read as.** A diagnosis, a health summary or a clinician's advice. A next step
is the product's, and your `meaning` and action labels say who is speaking. A result
that may distress needs [High-stakes moments](../health/high-stakes-moments.mdx)
around it.

**Colour axis.** Both, as [Two colour axes](../health/two-colour-axes.mdx) requires:
status reaches only the [StatusPill](./status-pill.mdx), category only the title, and
no prop tints the surface.

**Thresholds.** The product's. No default [range](../health/reference-ranges.mdx),
status derivation ([Two colour axes](../health/two-colour-axes.mdx)) or staleness
boundary ([Trends and uncertainty](../health/trends.mdx)) exists here;
`staleAfterHours` passes through to [RelativeTime](./relative-time.mdx). A reading you
cannot vouch for must not drive `attention` or `urgent`.

**Provenance and privacy.** `provenance` is free text with no
[class](../health/trends.mdx), so keep an estimated or self-reported value free of
`status` yourself. It has no mask; [Consent and privacy](../health/consent-and-privacy.mdx) is
built around the card.

## Accessibility [#accessibility]

The audit changed nothing, finding no axe violation, target below the 44px floor or
focus-visible gap. The title is a real heading at the caller's level, the
[StatusPill](./status-pill.mdx) carries a word and an icon, and the card reflows
unclipped at 320px and 200%.

**Residual items.**

* By design, the root `<article>` takes `aria-label` from the title, not
  `aria-labelledby`, matching the visible heading. A visible-heading reference is a
  future enhancement.
* `className` merges onto the root, so a caller's `truncate` can clip a reading. The
  component truncates nothing; the JSDoc warns of it.
* No gate checks print, `forced-colors` or `prefers-contrast`.

<KeyboardTable
  name="result-card"
  rows="[
  {
    keys: &#x22;Tab&#x22;,
    action: &#x22;Moves to the first action, where the card has one&#x22;,
    notes: &#x22;The card itself is not a tab stop.&#x22;,
  },
  {
    keys: &#x22;Shift + Tab&#x22;,
    action: &#x22;Moves backwards through the same stops&#x22;,
    notes: &#x22;Reverse order matches visual order.&#x22;,
  },
  {
    keys: &#x22;Enter&#x22;,
    action: &#x22;Activates the focused action&#x22;,
    notes: &#x22;Platform behaviour. Nothing is destructive.&#x22;,
  },
  {
    keys: &#x22;Space&#x22;,
    action: &#x22;Activates a focused button action&#x22;,
    notes: &#x22;On an onSelect action only.&#x22;,
  },
  {
    keys: &#x22;Escape&#x22;,
    action: &#x22;Nothing&#x22;,
    notes: &#x22;Not dismissible. Inside a Sheet or Dialog, Escape is theirs.&#x22;,
  },
  {
    keys: &#x22;Arrow keys&#x22;,
    action: &#x22;Nothing&#x22;,
    notes: &#x22;The bar is role=\&#x22;img\&#x22;, not a slider.&#x22;,
  },
]"
/>

<ContrastReport component="result-card" />

## Props interface [#props-interface]

<PropsTable name="ResultCardProps" />

`now` and `precision` are required: the card never reads the clock, so pass one
`now` to every card on a screen. `value` is `number | null`, never a string; a
pair is `segments`. A third action, a second `recommended` and a `titleLevel`
outside 2 to 6 each warn once and fall back.

### Data attributes [#data-attributes]

<DataAttributesTable
  name="result-card"
  rows="[
  {
    attribute: &#x22;data-slot&#x22;,
    condition: &#x22;On every part, always&#x22;,
    value: &#x22;result-card, result-card-header, -title, -time, -reading, -meaning, -actions, -footnote; result-card-action on a link action, button on an onSelect action&#x22;,
  },
  {
    attribute: &#x22;data-status&#x22;,
    condition: &#x22;On the embedded StatusPill only, with a status&#x22;,
    value: &#x22;steady | watch | attention | urgent&#x22;,
  },
  {
    attribute: &#x22;data-category&#x22;,
    condition: &#x22;On ResultCard.Title, for one of the six categories&#x22;,
    value: &#x22;sleep | heart | activity | nutrition | mind | labs&#x22;,
  },
  {
    attribute: &#x22;data-opsinjs-value&#x22;,
    condition: &#x22;On every Value, including a drawn RangeBar's. De-duplicate before scraping.&#x22;,
    value: &#x22;The unrounded number, or an empty string with no reading&#x22;,
  },
]"
/>
