🎉 We are thrilled to introduce FastStore v2. If you are looking for documentation of the previous version of FastStore, please refer to FastStore v1.

Radio

Radios allow users to select one option from a set.

Overview


Import

Import the component from @faststore/ui

import { Radio } from '@faststore/ui'

Import Styles

import '@faststore/ui/src/components/atoms/Radio/styles.scss'

Usage

<Radio />

Props

NameTypeDescriptionDefault
testIdstringID to find this component in testing tools (e.g.: cypress, testing library, and jest).fs-radio

Design Tokens

Local tokenDefault value/Global token linked
--fs-radio-width1.25rem
--fs-radio-heightvar(--fs-radio-width)
--fs-radio-border-widthvar(--fs-border-width)
--fs-radio-border-radiusvar(--fs-border-radius-circle)
--fs-radio-border-color
var(--fs-border-color)
--fs-radio-border-color-hover
var(--fs-border-color-hover)
--fs-radio-transitionborder var(--fs-transition-timing) var(--fs-transition-function), background-color var(--fs-transition-timing) var(--fs-transition-function), box-shadow var(--fs-transition-timing) var(--fs-transition-function)
--fs-radio-bkg-color-hover
var(--fs-color-primary-bkg-light)
--fs-radio-shadow-hover0 0 0 var(--fs-radio-border-width) var(--fs-border-color-active)

Nested Elements

Knob

Local tokenDefault value/Global token linked
--fs-radio-knob-widthvar(--fs-spacing-1)
--fs-radio-knob-heightvar(--fs-radio-knob-width)
--fs-radio-knob-bkg-color
var(--fs-color-body-bkg)
--fs-radio-knob-disabled-bkg-color
var(--fs-color-neutral-5)

Variants

Checked

<Radio checked />
Local tokenDefault value/Global token linked
--fs-radio-checked-bkg-color
var(--fs-color-primary-bkg)
--fs-radio-checked-bkg-color-hover
var(--fs-color-primary-bkg-hover)

Disabled

<Radio checked disabled />
Local tokenDefault value/Global token linked
--fs-radio-disabled-bkg-color
var(--fs-color-disabled-bkg)
--fs-radio-disabled-border-widthvar(--fs-radio-border-width)
--fs-radio-disabled-border-color
var(--fs-border-color-disabled)
--fs-radio-disabled-text-color
var(--fs-color-disabled-text)

Customization

For further customization, you can use the following data attributes:

data-fs-radio


Best Practices

âś… Do's

  • Provide a Label when using radio input. Descriptive labels help users understand the purpose of a form control.

Related components

  • RadioField

    RadioField wraps a Radio input and its corresponding Label.

    See more