IconFrame
IconFrameFramed symbol Give a symbol its own visual weight. Three sizes, every semantic tone, and the full range of surface treatments.
Layout & contentIn context
A flexible foundation
Compose a responsive interface from focused building blocks.
Theme awareUse the frame for emphasis and the nearby text for meaning. The icon is decorative here.
<div class="component-recipe">
<Flex align="start">
<IconFrame name="lucide:layout-grid" tone="feature" size="lg" variant="spotlight" aria-hidden="true"/>
<div>
<h3>A flexible foundation</h3>
<p>Compose a responsive interface from focused building blocks.</p>
<Badge tone="feature">Theme aware</Badge>
</div>
</Flex>
</div> Three frame sizes
Use a small frame for compact metadata and a larger frame to introduce a section.
<Flex align="center" wrap="true">
<IconFrame name="lucide:check" tone="success" size="sm" aria-hidden="true" />
<IconFrame name="lucide:check" tone="success" size="md" aria-hidden="true" />
<IconFrame name="lucide:check" tone="success" size="lg" aria-hidden="true" />
<span>Small, medium and large</span>
</Flex> Tone and treatment
Frames consume the same semantic palette as surrounding components.
<Flex align="center" wrap="true">
<IconFrame name="lucide:mail" tone="accent" variant="solid" aria-hidden="true" />
<IconFrame name="lucide:mail" tone="info" variant="surface" aria-hidden="true" />
<IconFrame name="lucide:mail" tone="neutral" variant="outline" aria-hidden="true" />
<span>Message destinations</span>
</Flex> All semantic tones
All ten supported tones. A semantic palette communicates intent; visible labels keep the meaning explicit.
neutral accent feature secondary custom ghost info success warning danger Every value is visible. Compare treatments in the site’s light and dark themes.
All visual variants
All eighteen supported treatments, shown together.
solid surface surfaceAlt spotlight glass flat flatAlt flatSolid outlineFill outline subtle subtleBtn link sheen underline rail bracket none Every value is visible. Compare treatments in the site’s light and dark themes.
Variant modes
Stateless shows the base treatment. Stateful includes hover, focus, and active styling; it does not add an action handler.
stateless stateful Every value is visible. Compare treatments in the site’s light and dark themes.
All frame sizes
sm, md, and lg shown side by side with the same symbol and treatment.
sm md lg Every value is visible. Compare treatments in the site’s light and dark themes.
Behavior and accessibility
IconFrame is a span, not a control. Use a visible label alongside decorative frames or an accessible wrapper for meaningful standalone symbols. A missing name removes the frame.
API reference
IconFrame contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
name
RefOrValue<string> - Default
not set
Exact registered SVG icon name, including its collection prefix.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
size
RefOrValue<IconFrameSize> - Default
md
Frame size: sm, md or lg. Invalid values use the medium frame.
variant
RefOrValue<ComponentVariant> - Default
solid
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
variantMode
RefOrValue<ComponentVariantMode> - Default
stateless
Use stateless for content surfaces; stateful enables the treatment’s hover, focus and active styles. It does not add interaction handlers.
Composition
No slots. Register defineIconComponents with the icon resolver; it registers both Icon and IconFrame.