Skip to content
Kimenpre-v1documentation home
Color scheme

ki-suggestion

Place each ki-suggestion directly inside a suggestions group. Put the prompt as plain text in the default slot. The visible title supplies the button’s accessible name and the prompt text emitted by the group.

Theme for this example
Color scheme for this example
Draft release notes Plan the next release
<ki-suggestions label="Start a conversation" variant="cards">
<ki-suggestion description="For the merged pull requests">Draft release notes</ki-suggestion>
<ki-suggestion>Plan the next release</ki-suggestion>
</ki-suggestions>

Use description for optional context, such as the source material or the scope of the prompt. Cards render it under the title. When supplied, it gives assistive technology separate context in either variant.

API reference

When to use: offer one short, actionable prompt in a suggestion group.

When not to use: navigation, static content, or a submitted form value.

Properties & attributes

AttributePropertyTypeDefaultDescription
descriptiondescriptionstring | undefined–Optional accessible description, visible below the title in cards.

Slots

SlotDescription
(default)Plain text forming the visible and accessible prompt title.

CSS parts

PartDescription
buttonThe native suggestion button.
descriptionOptional supporting text shown in cards.

CSS custom properties

The public styling contract of ki-suggestion: reassign these tokens at :root or on a subtree — never override internals.

TokenDescription
--ki-density-target-minThe smallest pointer target any density may produce: 24 x 24 CSS px by default and in compact (WCAG 2.5.8 AA), 44 x 44 in touch (WCAG 2.5.5). It floors a shrinking control but never lifts what a control paints: a control painted smaller extends its target to it, invisibly; rows and tabs grow to it (spec 045 A1).
--ki-focus-ring-colorColour of the keyboard focus ring every focusable component draws: 3:1 or more against the page in every theme and scheme.
--ki-focus-ring-offsetGap between a focusable component and its keyboard focus ring.
--ki-focus-ring-widthThickness of the keyboard focus ring every focusable component draws (its outline). One token instead of one per component, so a mode or a theme changes every ring at once.
--ki-suggestion-backdrop-filterFilter behind the chip surface.
--ki-suggestion-bgResting chip surface.
--ki-suggestion-bg-imageImage layered over the chip surface.
--ki-suggestion-borderResting chip boundary.
--ki-suggestion-border-widthBoundary width for either suggestion variant.
--ki-suggestion-card-description-fgResting card description.
--ki-suggestion-card-gapSpace between the card title and description.
--ki-suggestion-card-hover-description-fgDescription over the card hover surface.
--ki-suggestion-card-pressed-description-fgDescription over the pressed card surface.
--ki-suggestion-description-line-heightLine height of the card description.
--ki-suggestion-description-sizeType size of the card description.
--ki-suggestion-fgResting chip title.
--ki-suggestion-font-familyTypeface of the suggestion text.
--ki-suggestion-font-sizeType size of the prompt title.
--ki-suggestion-heightMinimum painted height of a chip.
--ki-suggestion-hover-bgChip surface on a hovering device.
--ki-suggestion-hover-fgTitle over the chip hover surface.
--ki-suggestion-insetInline padding for either variant.
--ki-suggestion-line-heightLine height of the prompt title.
--ki-suggestion-pressed-bgChip surface while a pointer or key holds activation.
--ki-suggestion-pressed-fgTitle over the pressed chip surface.
--ki-suggestion-radiusRounded outline of a chip.
--ki-suggestion-weightWeight of chip titles and card descriptions.

Configure the group and composer