Site color

Choose your site’s color palette.

Saved on this device.

IconFrame

IconFrameFramed symbol

Give a symbol its own visual weight. Three sizes, every semantic tone, and the full range of surface treatments.

Layout & content

In context

A visual anchor for a cardCOMPOSITION

A flexible foundation

Compose a responsive interface from focused building blocks.

Theme aware

Use 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.

Small, medium and large
<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.

Message destinations
<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.

All semantic tonesCOMPOSITION
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.

All visual variantsCOMPOSITION
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.

Variant modesCOMPOSITION
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.

All frame sizesCOMPOSITION
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.