AurumRadioButton

Aurum's radio button — a single-choice selection control.

familySelection
platformiOS 17+ · SwiftUI
figmacomponent master ↗
sourceSources/Aurum/Component/Selection/AurumRadioButton.swift
code connectFigmaConnect/Sources/AurumFigmaConnect/AurumRadioButton.figma.swift

Aurum's radio button — a single-choice selection control. The SwiftUI port of aurum-android's AurumRadioButton (Figma radioButton, node 5126:2507, axes isChecked × states × radioTypes).

Pass label: nil to render only the circle (Figma's withoutLabel variant). Use AurumRadioGroup when you have a set of mutually exclusive options; this view is the building block for one of them.

Intended use

Use as the building block inside AurumRadioGroup. Reach for it directly only when you need a single radio circle outside a group context (e.g. an option summary card). For sets of mutually exclusive options, always compose them via AurumRadioGroup so selection state stays consistent.

Do

  • Place the label .end (default) for vertical lists; switch to .start only inside full-width list rows where the radio anchors the trailing edge.
  • Use subtext for short helper copy that disambiguates the option — keep it under one line.
  • Pair error: true with a feedback-negative helper line on the parent surface to communicate validation failure.

Don’t

  • Use a single radio button to represent a binary toggle — use AurumSwitch instead.
  • Render multiple AurumRadioButtons manually side-by-side; compose them via AurumRadioGroup so the group enforces single-selection invariants.
  • Hand-roll a "radio fill" colour by overlaying Aurum.colors.*; recolour through error only.

Code Connect

Mapped to Figma node 5126:2507 ↗ — SwiftUI snippets appear in Dev Mode for the latest release.