UI Components
Atoms
Select

Select

Select components allow users to pick an option from a predefined list. The Select component should be used when there are more than 5 options available. Otherwise, consider using the RadioGroup component.

Overview

Import

Import the component from @faststore/ui

import { Select } from '@faststore/ui'

Import Styles

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

Usage

<Select
  options={{
    great: 'Great',
    ok: 'Ok',
    bad: 'Bad',
  }}
/>

Props

NameTypeDescriptionDefault
Coming Soon

Design Tokens

Local tokenDefault value/Global token linked
--fs-select-heightvar(--fs-spacing-6)
--fs-select-min-heightvar(--fs-control-tap-size)
--fs-select-paddingvar(--fs-spacing-1) var(--fs-spacing-5) var(--fs-spacing-1) var(--fs-spacing-2)
--fs-select-text-color
var(--fs-color-link)
--fs-select-border-radiusvar(--fs-border-radius)
--fs-select-bkgtransparent
--fs-select-bkg-color-focus
var(--fs-color-primary-bkg-light)
--fs-select-bkg-color-hover
var(--fs-select-bkg-color-focus)
--fs-select-transition-timingvar(--fs-transition-timing)
--fs-select-transition-propertyvar(--fs-transition-property)
--fs-select-transition-functionvar(--fs-transition-function)

Nested Elements

Icon

Local tokenDefault value/Global token linked
--fs-select-icon-color
var(--fs-color-link)
--fs-select-icon-position-rightvar(--fs-spacing-2)
--fs-select-icon-widthvar(--fs-spacing-3)
--fs-select-icon-heightvar(--fs-select-icon-width)

Variants

Disabled

<Select
  id="select-disabled"
  options={{
    great: 'Great',
    ok: 'Ok',
    bad: 'Bad',
  }}
  disabled
/>
Local tokenDefault value/Global token linked
--fs-select-disabled-text-color
var(--fs-color-disabled-text)
--fs-select-disabled-text-opacity1

Customization

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

data-fs-select

data-fs-select-icon

Best Practices

✅ Do's

  • Consider using a RadioGroup when few options are available. Doing so will prevent users from opening a dropdown box just to scan how many and which options are available.
  • Consider using an open text Input when several options are available and if the entries don’t need to be validated. Doing so will prevent users from having to read and understand all options before making a choice.
  • Consider using an autocomplete field when multiple options are available and if the inputs need to be validated.
  • Opt to grey out unavailable items instead of removing them completely.

Related components

  • SelectField

    SelectField wraps a Select input and its corresponding Label. It allows users to select one option from a set.

    See more
RadioSkeleton