Sizes
Small
12px top and bottom padding, the smaller corner radius and a 4px gap between the header and the body.
<ButtonCard size="sm" label="Small" body="Body copy" />Medium
The default size. 16px padding and an 8px gap between the header and the body.
<ButtonCard size="md" label="Medium" body="Body copy" />Content
Label only
The descriptor and the body are both optional. A label on its own gives a compact card.
<ButtonCard label="Passport" />Label, descriptor and body
The descriptor sits between the label and the body. The label is the accessible name, and the descriptor and body are the accessible description.
<ButtonCard label="Passport" descriptor="Photo ID" body="Upload a photo of the main page." />Disabled
Disabled
Uses the disabled fill, edge and label colours, and ignores presses.
<ButtonCard label="Passport" body="Upload a photo of the main page." disabled />Link
Link
Set href to render a real link. A link cannot be disabled. Add external to open in a new tab.
<ButtonCard label="Help centre" body="Opens in a new tab." href="https://www.checkatrade.com" external />When to use
- A navigation or action choice that needs a short explanation. For example, picking which document to upload, where each option opens a next step.
- A list of options that each lead somewhere. The chevron signals that pressing the card moves on.
When not to use
- A choice that is selected and stays selected. Use a Checkbox Card, Radio Card or Switch Card. A button card has no selected state.
- A short, self-evident action. Use a plain Button.
Button Card vs the input cards
A button card shares the input cards’ fill, edge, label tokens, sizes, radius, padding and descriptor and body slots. The difference is behaviour: an input card holds a value, a button card runs an action when pressed.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| label | string | Primary text line. Required. It is the accessible name on web. | |
| descriptor | string | Optional secondary line beneath the label. | |
| body | string | Optional body copy on its own full-width row. Omit it to drop the row. Exposed as part of the accessible description on web, and folded into the accessible name on native. | |
| size | 'sm' | 'md' | 'md' | Card padding, radius and row gap. Typography never changes with size. |
| disabled | boolean | false | Blocks presses and shows the disabled colours. Not allowed with href. |
| href | string | Makes the card a link: a real anchor on web, Linking on iOS and Android. A link cannot be disabled. | |
| external | boolean | false | Needs href. Opens in a new tab with a safe rel, and adds "(opens in a new tab)" to the accessible name. |
| onClick | MouseEventHandler | Web only. Fires when the card is pressed. | |
| onPress | (event) => void | Native only. Fires when the card is pressed. | |
| accessibilityLabel | string | Native only. Overrides the accessible name outright. |
No style or className. The chevron is fixed.
Import
// Web
import { ButtonCard } from '@checkatrade/components-web';
// Native
import { ButtonCard } from '@checkatrade/components-native';Basic usage
<ButtonCard
label="Passport"
descriptor="Photo ID"
body="Upload a photo of the main page."
onClick={() => openUpload('passport')}
/> Platform status
| Platform / Area | Status |
|---|---|
| Design (Figma) | In Progress |
| Web (React) | In Progress |
| Native (React Native) | In Progress |
| iOS (Swift) | Planned |
| Android (Kotlin) | Planned |
| Accessibility audit | Planned |
The Figma source is still a draft: it shows one size and no descriptor, body or states. The descriptor, body, sizes, hover and disabled states were taken from the input cards.
Accessibility
Web
- The card is a real
<button type="button">, so it is focusable and pressed with Enter or Space. - The label is the accessible name. The descriptor and body are the accessible description.
- The chevron is decorative and hidden from assistive tech.
- Keyboard focus shows the 4px focus ring outside the card.
React Native
- The card is a
PressablewithaccessibilityRole="button"andaccessibilityState={{ disabled }}. - Native has no description slot, so the name is the label, descriptor and body joined with a full stop. A consumer
accessibilityLabeloverrides it outright. - The text is hidden from assistive tech so the card stays one accessibility node.
Token gaps
- The Figma draft binds the generic border and an unbound white fill. The card uses the
selectortoken family instead, so it matches the input cards. Decision: use the input cards’ tokens. (Design, Oliver Maton, 2026-11-19) - Native
Textcannot take the card’s label tokens. Web colours the text from theselectorlabel tokens. Native keeps the default ink and dims a disabled card’s text instead. - Pressed uses the selected tokens. A button holds no value, so the input cards’
selectedfill, edge and label tokens are its pressed look, on web and native. (Design, Oliver Maton, 2026-11-19) - The chevron takes the same ink as the text. The Figma draft uses the
informationink. The chevron now follows the label colour through rest, hover, pressed and disabled on web, and keeps the default ink and dims when disabled on native. (Design, Oliver Maton, 2026-11-19)
No releases yet.