Select Field

FastStore UI components Molecules

Select Field

SelectField grouped a Select input and its corresponding Label.

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

Overview

Example

Code

Select a Status:

Import

Import the component from @faststore/ui


_10import { SelectField } from '@faststore/ui'

Import Styles into your FastStore project

To apply the styles of this component in your FastStore project, import the following into your stylesheet:


_10@import '@faststore/ui/src/components/molecules/SelectField/styles.scss';

Follow the instructions in the Importing FastStore UI component styles tutorial.

Usage

Order by:


_10<SelectField
_10  id="select-order-by"
_10  label="Order by:"
_10  options={{
_10    name_asc: 'Name, A-Z',
_10    name_desc: 'Name, Z-A',
_10    top_sales: 'Top Sales',
_10  }}
_10/>

Props

Name	Type	Description	Default
label*	`string`	Defines the text displayed in the label right next to the Select.
testId	`string`	ID to find this component in testing tools (e.g.: cypress, testing library, and jest).	`fs-select-field`
id*	`string`	Assigns an identifier to link the UISelect component and its label.
options*	`Record<string, string>`	Defines the options available in the select. The SelectOptions object keys are the property names, while the values correspond to the text that will be displayed in the UI.

Design Tokens

Local token	Default value/Global token linked
`--fs-select-label-color`	`var(--fs-color-text-light)`
`--fs-select-label-margin-right`	`var(--fs-spacing-1)`

Customization

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

data-fs-select-field

data-fs-select-field-label