Skip to content
Kimenpre-v1documentation home
Color scheme

ki-carousel-item

Use one item per slide. Put text, links and controls in the default slot. For layouts with previews, add decorative media to the preview slot. The parent carousel assigns the item’s position name and manages whether its content is available.

Theme for this example
Color scheme for this example
Read the guide Choose a theme
<ki-carousel label="Tour">
<ki-carousel-item><a href="#guide">Read the guide</a></ki-carousel-item>
<ki-carousel-item>Choose a theme</ki-carousel-item>
</ki-carousel>

When to use: supply a single slide to a ki-carousel. Put the full slide in the default slot and optional decorative preview media in the preview slot.

When not to use: present a standalone card or a layout container outside a carousel.

SlotDescription
(default)The full slide content, including any links and controls.
previewDecorative, noninteractive media shown when the item is a reduced preview.
PartDescription
contentSurface that holds the full slide.
previewDecorative surface used in small or partly shown previews.

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

TokenDescription
--ki-carousel-item-backdrop-filterComplete optional backdrop filter for the slide surface.
--ki-carousel-item-bgSurface for carousel slide content and its decorative preview.
--ki-carousel-item-bg-imageOptional image layered over the slide background color.
--ki-carousel-item-fgText on the carousel slide surface.
--ki-carousel-item-min-block-sizeMinimum block size of a full slide.
--ki-carousel-item-paddingInset of full slide content.
--ki-carousel-radiusCorner radius shared by the carousel viewport and slide surfaces.
--ki-control-border-widthStroke width of the boundary of a compact control.
--ki-density-space-scaleMultiplies every scaled container padding and gap (card, dialog, alert, list, list item, select listbox, tab panel, tooltip).
--ki-typography-family-bodysemantic font family for typography family body.