Skip to content

Selection

Button Card

In progress

A card that is a button, available on web (React) and native (React Native). Two sizes, a required label, an optional descriptor and body, a trailing chevron, and the whole card as the press target.

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

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

PropTypeDefaultDescription
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 / AreaStatus
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 Pressable with accessibilityRole="button" and accessibilityState={{ disabled }}.
  • Native has no description slot, so the name is the label, descriptor and body joined with a full stop. A consumer accessibilityLabel overrides 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 selector token family instead, so it matches the input cards. Decision: use the input cards’ tokens. (Design, Oliver Maton, 2026-11-19)
  • Native Text cannot take the card’s label tokens. Web colours the text from the selector label 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’ selected fill, 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 information ink. 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.

Select a brand to demo:
Active brand: checkatrade