Icon
tone neutral/accent/success/warning/error/info
Conjunto de ícones do kit: Hugeicons Stroke Rounded, traço 1,5 px, herdando a cor do texto.
Ícones com movimento
<div class="flex flex-wrap items-center gap-2.5"><.icon name="refresh" size="lg" class="animate-[lu-spin_1.2s_linear_infinite]" /><.icon name="bell" size="lg" class="origin-top animate-[mo-wiggle_5s_ease-in-out_infinite]" /><.icon name="sparkles" size="lg" class="animate-[mo-pulse_2s_ease-in-out_infinite] text-neg" /><.icon name="sparkles" size="lg" class="animate-[mo-float_4s_ease-in-out_infinite] text-accent-600" /></div>
tone
<div class="flex flex-wrap items-center gap-2.5"><.icon name="check-circle" size="md" boxed /><.icon name="check-circle" size="md" boxed tone="acc" /><.icon name="check-circle" size="md" boxed tone="pos" /><.icon name="check-circle" size="md" boxed tone="neg" /><.icon name="check-circle" size="md" boxed tone="warn" /><.icon name="check-circle" size="md" boxed tone="info" /></div>
Biblioteca do kit (72 mais usados)
<div class="flex flex-wrap items-center gap-1.5"><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="home"><.icon name="home" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="search"><.icon name="search" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="inbox"><.icon name="inbox" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="grid"><.icon name="grid" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="trend-up"><.icon name="trend-up" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="users"><.icon name="users" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="layers"><.icon name="layers" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="table"><.icon name="table" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="user-minus"><.icon name="user-minus" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="file"><.icon name="file" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="folder"><.icon name="folder" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="settings"><.icon name="settings" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="help"><.icon name="help" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bell"><.icon name="bell" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="moon"><.icon name="moon" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="sun"><.icon name="sun" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="calendar"><.icon name="calendar" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="compare"><.icon name="compare" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="filter"><.icon name="filter" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="download"><.icon name="download" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="upload"><.icon name="upload" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="arrow-up-right"><.icon name="arrow-up-right" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="arrow-right"><.icon name="arrow-right" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="chevron-down"><.icon name="chevron-down" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="plus"><.icon name="plus" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="x"><.icon name="x" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="check"><.icon name="check" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="more-h"><.icon name="more-h" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="sparkles"><.icon name="sparkles" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="ai"><.icon name="ai" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="message"><.icon name="message" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="chat"><.icon name="chat" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="mail"><.icon name="mail" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="lock"><.icon name="lock" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="eye"><.icon name="eye" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="copy"><.icon name="copy" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="trash"><.icon name="trash" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="edit"><.icon name="edit" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="star"><.icon name="star" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="clock"><.icon name="clock" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="send"><.icon name="send" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="attach"><.icon name="attach" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="mic"><.icon name="mic" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="info"><.icon name="info" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="alert"><.icon name="alert" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="check-circle"><.icon name="check-circle" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="link"><.icon name="link" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="refresh"><.icon name="refresh" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="kanban"><.icon name="kanban" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="list"><.icon name="list" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="image"><.icon name="image" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="package"><.icon name="package" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="wallet"><.icon name="wallet" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bank"><.icon name="bank" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="invoice"><.icon name="invoice" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="shield"><.icon name="shield" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="code"><.icon name="code" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="terminal"><.icon name="terminal" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="bot"><.icon name="bot" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="palette"><.icon name="palette" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="card"><.icon name="card" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="building"><.icon name="building" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="tag"><.icon name="tag" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="cart"><.icon name="cart" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="timer"><.icon name="timer" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="target"><.icon name="target" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="dollar"><.icon name="dollar" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="rocket"><.icon name="rocket" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="flow"><.icon name="flow" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="brain"><.icon name="brain" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="key"><.icon name="key" /></span><span class="grid size-10 place-items-center rounded-[10px] border border-line text-ink-2" title="server"><.icon name="server" /></span></div>
Tamanhos
<div class="flex flex-wrap items-center gap-2.5"><.icon name="package" size="sm" /><.icon name="package" size="md" /><.icon name="package" /><.icon name="package" size="lg" /><.icon name="package" size="xl" /></div>
Em caixa por estado
<div class="flex flex-wrap items-center gap-2.5"><.icon name="sparkles" boxed tone="acc" /><.icon name="check" boxed tone="pos" /><.icon name="x-circle" boxed tone="neg" /><.icon name="alert" boxed tone="warn" /><.icon name="info" boxed tone="info" /><.icon name="ai" boxed tone="lime" /><.icon name="file" boxed /></div>
Uso
<.icon name="hugeicons:analytics-up" class="size-[18px]" /> <!-- HTML puro --> <i data-i="trend-up"></i> + LedgerUI.hydrate()
Regras
- Fonte oficial: hugeicons.com/icons/stroke-rounded (pacote @hugeicons/core-free-icons).
- Tamanho padrão 18px em navegação, 16px dentro de botões, 14px em badges.
- Ícones herdam
currentColor; ícone decorativo ficaaria-hidden, botão só-ícone recebearia-label. - Em caixa (
.lu-ic) o fundo segue o estado: acc, pos, neg, warn, info, lime.
Referência da API
Todos os function components, atributos, valores e slots que este componente cobre.
Server-side SVG icons (Hugeicons Stroke Rounded), no JavaScript needed.
<.icon name="download" />
<.icon name="huge-download-01" size="sm" class="text-muted" />
<.icon name="check-circle" boxed tone="success" />
The SVG is styled only with Tailwind utilities (stroke follows currentColor, so text-*
colours it). size picks the box: sm 14px, md 16px, base 18px (default), lg 22px,
xl 28px. Use size, not a size-* class, to change it: two utilities of one property in a
class list are resolved by the stylesheet, not by their order.
<svg class="... size-[18px]" viewBox="0 0 24 24" aria-hidden="true" data-icon="download">...</svg>
Every icon is precomputed at compile time from priv/icons.json (regenerate it with
elixir scripts/extract_icons.exs) as an iodata binary and emitted with Phoenix.HTML.raw/1,
so rendering costs one map lookup.
Names
Dictionary keys (download, chevron-down, ...) are used as-is. The API's huge-* names
are accepted too: huge- (or hugeicons:) is stripped, then the exact key is tried, then
the key without a trailing -NN suffix (huge-download-01 -> download-01 -> download).
Unknown names render nothing and log a warning (disable with
config :ledger_ui, warn_unknown_icons: false).
Vendored icons
Icons outside the dictionary come from the app's own folder, filled by mix ledger_ui.icons
(get, sync; see LedgerUI.Icons):
config :ledger_ui, :icons_path, "priv/hugeicons"
<.icon name="huge-invoice-01" />
They are loaded once into :persistent_term and render the same markup as the built-in ones.
Order of lookup: a built-in key (exact, after dropping huge-), then a vendored file of that
name, then the built-in key without its -NN suffix. So a built-in name always wins over a
vendored file of the same name, while huge-download-01 finds the vendored download-01.svg
before settling for the built-in download.
Box
boxed wraps the icon in a rounded square box (32px; 44px with box_size="lg"); tone colours it (accent/acc, success/pos,
error/neg, warning/warn, info, lime, neutral). box_size="lg" gives the large
box; any number of pixels sets width/height inline. The inner block replaces name.
<.icon>
| Attr | Type | Default | Values / notes |
|---|---|---|---|
name |
:string |
nil |
Icon name (dictionary key or huge-*). |
size |
:string |
"base" |
nil, base, lg, md, sm, xl - sm 14px, md 16px, base 18px, lg 22px, xl 28px (nil is base). |
class |
:any |
nil |
|
boxed |
:boolean |
false |
Wraps the icon in a rounded square box. |
tone |
:string |
nil |
nil, acc, accent, error, info, lime, neg, neutral, pos, success, warn, warning - Box colour (needs boxed). |
box_size |
:any |
nil |
"lg" or a size in pixels. |
box_class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:inner_block>- Own SVG inside the box, instead ofname.