Product Grid
It's a section generally used on PLP pages to list the products available in the store.
The ProductGrid
is a compound of the following:
ProductGrid
: wraps the product grid items.ProductGridItem
: wraps the product inside a list item.ProductCard
: the proposed child of aProductGridItem
.
Import
Import the component from @faststore/ui
import { ProductGrid, ProductGridItem } from '@faststore/ui'
We highly recommend using the ProductCard as the direct child of the ProductGridItem
.
import {
ProductCard,
ProductCardContent,
ProductCardImage,
} 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:
@import '@faststore/ui/src/components/organisms/ProductGrid/styles.scss';
Follow the instructions in the Importing FastStore UI component styles tutorial.
Usage
Props
Product Grid
Name | Type | Description | Default |
---|---|---|---|
testId | string | ID to find this component in testing tools (e.g.: Cypress, Testing Library, and Jest). | fs-product-grid |
Product Grid Item
Name | Type | Description | Default |
---|---|---|---|
testId | string | ID to find this component in testing tools (e.g.: Cypress, Testing Library, and Jest). | fs-product-grid-item |
Design Tokens
Local token | Default value/Global token linked |
---|---|
--fs-product-grid-gap-mobile | var(--fs-grid-gap-0) |
--fs-product-grid-gap-tablet | var(--fs-product-grid-gap-mobile) |
--fs-product-grid-gap-desktop | var(--fs-grid-gap-2) |
--fs-product-grid-columns-mobile | 2 |
--fs-product-grid-columns-tablet | 4 |
--fs-product-grid-columns-desktop | var(--fs-product-grid-columns-tablet) |
Customization
data-fs-product-grid
data-fs-product-grid-item
Best Practices
✅ Do's
- Respect
ProductGridItem
content's width considering the space available on the page.
❌ Don'ts
- Avoid using a lot of
ProductGridItem
on the same row, this could lead to unwanted horizontal scroll.
Related components
Apple Magic Mouse
Original price:$999Price:$950.044k Philips Monitor 27”
Original price:$490Price:$420Echo Dot Smart Speaker
Original price:$310Price:$280Aedle VK-1 L Headphone
Original price:$150Price:$130Oculus VR Headset
Original price:$344Price:$315Apple AirPods Pro
Original price:$249Price:$229
Product Shelf
Displays a list of products to be used as a section on the store.
See more