Suggestions.
A good first question, one tap away.
Starter prompts as a wrapping list of buttons. Each sends its prompt through onSelect. Long prompts wrap into soft cards instead of overflowing.
Make it yours
Preparing the example…
Composition
AnatomyItems take Button's size, variant and color. Move focus to the composer after one is chosen, since the list usually disappears.
Suggestions.Root — ul aria-label="Suggestions"
└── Suggestions.Item (suggestion, onSelect) — li > ButtonA place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesSizes
Compare the three Dixy shirt sizes side by side.
Loading source…
Visual treatments
Emphasis changes presentation while the primitive keeps behavior.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native HTML attributes and refs are forwarded. The table covers Dixy’s own options.
SuggestionsRoot
| Prop | Type / description | Default |
|---|---|---|
aria-label | stringAccessible name of the list. | Suggestions |
SuggestionItem
| Prop | Type / description | Default |
|---|---|---|
suggestion* | stringThe prompt this suggestion sends. Also its label unless children are given. | — |
onSelect | ((suggestion: string) => void)Called with the suggestion when chosen. | — |
children | ComponentProps<typeof Button>["children"] | — |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-size-control-sm | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityA list announces how many prompts there are. Each button's name is its prompt, so it says exactly what will be sent.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
A 1.25em radius is a pill on one line and a soft card on two, so one rule handles every prompt length.
--dixy-size-control-sm