RecommendedForYou
A titled row of product picks, with a refresh action and the loading and failure treatments for that read.
RecommendedForYou
RecommendedForYou is the host-page region for one set of product picks. A pick can come from catalog popularity or from the member's own activity, so a host title or description must not promise personalization. The host resolves the read and hands the cards in, and a product press opens the product page. The region does not count refreshes, and it does not draw a heart or a cart control. Passing chat={false} hides the footnote, including a footnote the host passed. interestsPopover turns interests into a Popover trigger that opens on a mouse hover or a press. The Popover closes 300 ms after the mouse leaves, on a press outside it, or on Escape. On a device without hover, a tap opens the same content as a bottom Sheet. A host inside a shadow root passes interestsPopover.container, and the Popover and the Sheet both portal into it so they keep their styles. The card row hides its scrollbar thumb until a member hovers it or focuses into it.
Interaction Phases
State space: slot. 3 of 8 covered phases have a Figma frame; 5 have not been drawn.
| Phase | Space | What it renders | Figma frame |
|---|---|---|---|
idle | slot | The region exists, and nothing has been requested yet. | MISSING |
loading | slot | Declared and running. The one read phase a wait ladder escalates. | 4210:5825 |
success | slot | Content arrived and fills the declaration. | 4210:5826 |
empty | slot | The answer is legitimately nothing. A designed state, not an error. | MISSING |
timeout | slot | The bound expired. Distinct from failure: nobody said no. | MISSING |
failure | slot | The request was answered, and the answer was a failure. | 4354:38923 |
fallback | slot | Degraded content stands in for what was asked for. | MISSING |
cancelled | slot | Superseded or abandoned. Not a failure, and never scolded. | MISSING |
Politeness is handed down — the resolved state chooses it and this item renders it.
Storybook
Loading
Props
Prop
Type
Also takes the attributes of the element it renders.
Tokens
Derived from the component source at docs-generation time — these are the --augds-* variables it reads. Re-theme the colour slots by constructing a partner DesignSystemTheme and wrapping the consumer subtree in <ThemeProvider>, never by hard-coding values.
--augds-background-brand-tint-1--augds-background-inverse--augds-border-brand--augds-foreground-brand-readable--augds-foreground-primary--augds-foreground-secondary--augds-foreground-tertiary--augds-radius-primitive-20--augds-spacing-24--augds-spacing-32--augds-spacing-8--augds-surface-page-transparent--augds-surface-section
Source
src/components/ui/recommended-for-you/recommended-for-you.tsx