Usage & API Reference
EvIcon props
name
: string — icon name (strict union of generated names)size
: number | string | token — default32
(pixels)- tokens:
xs
(12),sm
(16),md
(24),lg
(32),xl
(40),2xl
(48),3xl
(56)
- tokens:
color
: string — any CSS color; defaults tocurrentColor
ariaLabel?
: string — accessible name; if omitted, icon isaria-hidden
Additional attributes are forwarded to the underlying SVG (e.g. stroke-width
, stroke-linecap
).
Per‑icon component props
size
,stroke
,strokeWidth
,linecap
,linejoin
,ariaLabel
— same asEvIcon
.color
— the primary way to set color; internally maps to rootfill
.fill
— legacy alias; if both provided,color
wins.
Names & types
- Icon names are kebab‑case:
- line variant:
address-book
- filled variant:
address-book-filled
- line variant:
- TypeScript helpers:
import { ICON_NAMES, type IconName } from '@evora-ui/icons-vue/icons/names'
.- Use
IconName
for strict typing of theEvIcon
name
prop.
Performance
- Prefer direct imports of explicit filled variants when you know the variant:
import { EvUserFilled } from '@evora-ui/icons-vue/icons'
— smallest bundles when you need filled. @evora-ui/icons-vue/icons
exports both default and explicit variants; tree‑shaking drops unused ones.EvIcon
is convenient for app‑wide provide; in hot paths prefer direct components.