ki-feature-icon
@kimen/elements/ki-feature-icon- Source
- Agent reference
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.
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
| Attribute | Property | Type | Default | Description |
|---|---|---|---|---|
shape | shape | "circle" | "square" | 'square' | Rounded square or circle. Unknown values use square. |
size | size | "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. |
tone | tone | "danger" | "info" | "neutral" | "primary" | "primary-light" | "success" | "warning" | 'neutral' | Colour pair for the tile and its glyph. Unknown values use neutral. |
Slots
| Slot | Description |
|---|---|
| (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
| Part | Description |
|---|---|
tile | The 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.
| Token | Description |
|---|---|
--ki-feature-icon-backdrop-filter | Complete filter applied behind the feature icon tile. |
--ki-feature-icon-bg | Background color of a neutral feature icon tile. |
--ki-feature-icon-bg-image | Optional background image painted over the feature icon tile color. |
--ki-feature-icon-circle-radius | Corner radius of a circular feature icon tile. |
--ki-feature-icon-danger-bg | Background color of a danger feature icon tile. |
--ki-feature-icon-danger-fg | Glyph color of a danger feature icon tile. |
--ki-feature-icon-fg | Glyph color of a neutral feature icon tile. |
--ki-feature-icon-info-bg | Background color of an info feature icon tile. |
--ki-feature-icon-info-fg | Glyph color of an info feature icon tile. |
--ki-feature-icon-lg-radius | Corner radius of a large square feature icon tile. |
--ki-feature-icon-lg-size | Edge length of a large feature icon tile. |
--ki-feature-icon-primary-bg | Background color of a primary feature icon tile. |
--ki-feature-icon-primary-fg | Glyph color of a primary feature icon tile. |
--ki-feature-icon-primary-light-bg | Background color of a primary-light feature icon tile. |
--ki-feature-icon-primary-light-fg | Glyph color of a primary-light feature icon tile. |
--ki-feature-icon-radius | Default corner radius of a square feature icon tile. |
--ki-feature-icon-size | Default edge length of a feature icon tile. |
--ki-feature-icon-sm-radius | Corner radius of a small square feature icon tile. |
--ki-feature-icon-sm-size | Edge length of a small feature icon tile. |
--ki-feature-icon-success-bg | Background color of a success feature icon tile. |
--ki-feature-icon-success-fg | Glyph color of a success feature icon tile. |
--ki-feature-icon-warning-bg | Background color of a warning feature icon tile. |
--ki-feature-icon-warning-fg | Glyph color of a warning feature icon tile. |
--ki-feature-icon-xl-radius | Corner radius of an extra-large square feature icon tile. |
--ki-feature-icon-xl-size | Edge length of an extra-large feature icon tile. |
--ki-feature-icon-xs-radius | Corner radius of an extra-small square feature icon tile. |
--ki-feature-icon-xs-size | Edge length of an extra-small feature icon tile. |
--ki-typography-family-body | semantic font family for typography family body. |