SearchAutoComplete
List of auto completing suggestions based on searched term.
1 min read
List of auto completing suggestions based on searched term. This component is part of the Search feature.
Example
Code
Searching for:
ApplUsage
Import the component
_10import { SearchAutoComplete, SearchAutoCompleteTerm } from "@faststore/ui";
Import styles
To apply styles, include the following in your stylesheet:
_10@import "@faststore/ui/src/components/molecules/SearchAutoComplete/styles.scss";
For details, see Importing FastStore UI component styles.
Examples
Other Icons
Example
Code
Searching for:
SoDesign tokens
| Local token | Default value/Global token linked |
|---|---|
--fs-search-auto-complete-padding-top | var(--fs-spacing-2) |
--fs-search-auto-complete-padding-right | var(--fs-spacing-3) |
--fs-search-auto-complete-padding-bottom | var(--fs-search-auto-complete-padding-top) |
--fs-search-auto-complete-padding-left | var(--fs-search-auto-complete-padding-right) |
--fs-search-auto-complete-transition-property | var(--fs-transition-property) |
--fs-search-auto-complete-transition-function | var(--fs-transition-function) |
--fs-search-auto-complete-transition-timing | var(--fs-transition-timing) |
Design tokens: Item
| Local token | Default value/Global token linked |
|---|---|
--fs-search-auto-complete-item-column-gap | var(--fs-spacing-1) |
--fs-search-auto-complete-item-text-size | var(--fs-text-size-2) |
--fs-search-auto-complete-item-line-height | 1.25 |
--fs-search-auto-complete-item-bkg-color-hover | var(--fs-color-tertiary-bkg-hover) |
Design tokens: Icon
| Local token | Default value/Global token linked |
|---|---|
--fs-search-auto-complete-item-icon-color | var(--fs-color-neutral-4) |
--fs-search-auto-complete-item-icon-size | 1.125rem |
Data attributes
You can target and override
SearchAutoComplete styles using the following data attributes:data-fs-search-auto-completedata-fs-search-auto-complete-itemdata-fs-search-auto-complete-item-linkdata-fs-search-auto-complete-item-iconProps
SearchAutoComplete
| Name | Type | Description | Default |
|---|---|---|---|
| testId | string | ID to find this component in testing tools (e.g.: cypress, testing library, and jest). | fs-search-auto-complete |
SearchAutoCompleteTerm
| Name | Type | Description | Default |
|---|---|---|---|
| testId | string | ID to find this component in testing tools (e.g.: cypress, testing library, and jest). | fs-search-auto-complete-term |
| linkProps | Partial<LinkProps<LinkElementType>> | Props for the link from term component. | |
| icon | string | number | false | true | {} | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | A React component that will be rendered as an icon. | <Icon name="MagnifyingGlass" width={18} height={18} /> |
| term* | string | Term researched. | |
| suggestion* | string | Suggestion proposed with auto complete. |