For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/v0.4.0/en/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/v0.4.0/en/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/v0.4.0/en/components/icon.md.

Icon

Provides a consistent size, stroke, and alignment slot for decorative cues or independently named graphics supplied by the host.

Live preview

Usage

<span class="icon" role="img" aria-label="Verified">
  <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M20 6 9 17l-5-5" /></svg>
</span>

Contract

SurfaceValue
Root selector.icon
Native root<span>
Statesready, decorative, labeled, host-provided
Events—
Methods—

Product boundary

It contains no provider branding and never replaces button labels or status text. Official identity uses Brand Lockup instead of masquerading as a generic icon.

The component publishes a reusable interaction boundary only. Data fetching, persistence, permission, trusted content, and business entities remain host-owned.

Accessibility

Decorative icons use aria-hidden; informative icons use role=img and a name. Unicode characters are not substitutes for a coherent icon asset.