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

UI Components
Molecules
Search Input Field

Search Input Field

An InputField with a search button. This component is part of the Search feature.

Import

Import the component from @faststore/ui

import { SearchInputField } from '@faststore/ui'

Import Styles

import '@faststore/ui/src/components/molecules/SearchInputField/styles.scss'

Usage

<SearchInputField onSubmit={() => {}} />

Props

NameTypeDescriptionDefault
testIdstringID to find this component in testing tools (e.g.: cypress, testing library, and jest).fs-search-input
buttonPropsButtonPropsProps for the submit button inside the input.
buttonIconstring | number | false | true | ReactElement<any, string | JSXElementConstructor<any>> | ReactFragment | ReactPortalA React component that will be rendered as an icon (submit button).<Icon name="MagnifyingGlass" />
aria-labelstringCustom aria-label for input and button.
onSubmit*(value: string) => voidCallback function when submitted.

Design Tokens

Local tokenDefault value/Global token linked
--fs-search-input-field-height-mobilevar(--fs-control-tap-size)
--fs-search-input-field-height-desktopvar(--fs-spacing-6)
--fs-search-input-field-transition-timingvar(--fs-transition-timing)
--fs-search-input-field-transition-functionease

Nested Elements

Button

Local tokenDefault value/Global token linked
--fs-search-input-field-button-min-heightvar(--fs-search-input-height-desktop)
--fs-search-input-field-button-padding-top-desktopvar(--fs-spacing-0)
--fs-search-input-field-button-padding-bottom-desktopvar(--fs-search-input-field-button-padding-top-desktop)

Input

Local tokenDefault value/Global token linked
--fs-search-input-field-input-padding-rightvar(--fs-search-input-field-button-width)
--fs-search-input-field-input-bkg-color
var(--fs-color-body-bkg)

Customization

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

data-fs-search-input-field

data-fs-search-input-field-input