@xwink/ui

Icon

全站图标唯一入口。名字统一用 Iconify 的 集合:名字(如 ph:list),去 icones.js.org 挑图标复制即用,全站优先 ph(Phosphor)集。

尺寸与颜色不由组件定:默认 1em 跟随字号,用 size-* / text-* 控制。

尺寸

尺寸跟随
ph:heart
ph:star
ph:bell
ph:magnifying-glass

L0 内联写法:

离线与 SSR

两条渲染路径:

  • 随包子集(库内组件用到的图标,清单在 packages/ui/core/scripts/gen-icons.mts)直接内联 SVG 路径,SSR 直出、首屏不闪、零网络。
  • 子集之外的名字(如运营配置的动态图标)回落 Iconify 运行时;宿主 addCollection 注册后同样离线——数据在 registry 里时 XIcon 自动打开 SSR 直出(本站就是这条路径的宿主,见 app/plugins/docs-icons.ts)。

API

Props

名称类型默认值说明
name 必填 stringIconify 的 `集合:名字`