Skip to content
Kimenpre-v1documentation home
Color scheme

ki-feature-icon

Place one decorative glyph beside a feature, empty state or settings heading. The heading names the section. Use ki-icon-button for actions and ki-badge for short status labels.

Theme for this example
Color scheme for this example

Security settings

<div style="display:flex;align-items:center;gap:var(--ki-space-md)">
<ki-feature-icon tone="primary-light">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round"
aria-hidden="true" focusable="false">
<circle cx="12" cy="12" r="10"></circle>
<path d="m16 9-5.5 5.5L8 12"></path>
</svg>
</ki-feature-icon>
<h2>Security settings</h2>
</div>

The tile defaults to neutral, medium and rounded square. The five sizes span 24 to 64 CSS pixels at a 16px root. The glyph takes half the selected size. Use shape="circle" for a circular tile. An imported ki-icon with its default inherited size also fits the slot.

The painted tile part and its glyph are hidden from assistive technology and skipped during keyboard navigation. The tile keeps its explicit size on touch screens, uses the system palette in forced colours and stays still when its appearance changes.

API reference

When to use: Place a decorative icon beside the visible heading of a feature, empty state or settings section. The heading carries the meaning.

When not to use: For an action (use ki-icon-button), a status (use ki-badge), or the sole label of a section.

Properties & attributes

AttributePropertyTypeDefaultDescription
shapeshape"circle" | "square"'square'Rounded square or circle. Unknown values use square.
sizesize"lg" | "md" | "sm" | "xl" | "xs"'md'Tile size. At a 16px root, the steps are 24, 32, 40, 48 and 64px. Unknown values use md.
tonetone"danger" | "info" | "neutral" | "primary" | "primary-light" | "success" | "warning"'neutral'Colour pair for the tile and its glyph. Unknown values use neutral.

Slots

SlotDescription
(default)One Lucide glyph. Supply an inline SVG using currentColor or a ki-icon with inherited size. Guarded surfaces use a registered ki-icon.

CSS parts

PartDescription
tileThe painted tile that centers the glyph.

CSS custom properties

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

TokenDescription
--ki-feature-icon-backdrop-filterComplete filter applied behind the feature icon tile.
--ki-feature-icon-bgBackground color of a neutral feature icon tile.
--ki-feature-icon-bg-imageOptional background image painted over the feature icon tile color.
--ki-feature-icon-circle-radiusCorner radius of a circular feature icon tile.
--ki-feature-icon-danger-bgBackground color of a danger feature icon tile.
--ki-feature-icon-danger-fgGlyph color of a danger feature icon tile.
--ki-feature-icon-fgGlyph color of a neutral feature icon tile.
--ki-feature-icon-info-bgBackground color of an info feature icon tile.
--ki-feature-icon-info-fgGlyph color of an info feature icon tile.
--ki-feature-icon-lg-radiusCorner radius of a large square feature icon tile.
--ki-feature-icon-lg-sizeEdge length of a large feature icon tile.
--ki-feature-icon-primary-bgBackground color of a primary feature icon tile.
--ki-feature-icon-primary-fgGlyph color of a primary feature icon tile.
--ki-feature-icon-primary-light-bgBackground color of a primary-light feature icon tile.
--ki-feature-icon-primary-light-fgGlyph color of a primary-light feature icon tile.
--ki-feature-icon-radiusDefault corner radius of a square feature icon tile.
--ki-feature-icon-sizeDefault edge length of a feature icon tile.
--ki-feature-icon-sm-radiusCorner radius of a small square feature icon tile.
--ki-feature-icon-sm-sizeEdge length of a small feature icon tile.
--ki-feature-icon-success-bgBackground color of a success feature icon tile.
--ki-feature-icon-success-fgGlyph color of a success feature icon tile.
--ki-feature-icon-warning-bgBackground color of a warning feature icon tile.
--ki-feature-icon-warning-fgGlyph color of a warning feature icon tile.
--ki-feature-icon-xl-radiusCorner radius of an extra-large square feature icon tile.
--ki-feature-icon-xl-sizeEdge length of an extra-large feature icon tile.
--ki-feature-icon-xs-radiusCorner radius of an extra-small square feature icon tile.
--ki-feature-icon-xs-sizeEdge length of an extra-small feature icon tile.
--ki-typography-family-bodysemantic font family for typography family body.

Workshop

Open ki-feature-icon in Storybook