Skip to content

虚拟模块

插件提供了几个虚拟模块,分别用于不同的使用场景。

virtual:svg-icons/register

默认情况下,插件会自动把 sprite 注入到页面中。 如果你希望从客户端入口显式控制这一步,例如在 src/main.ts 中统一处理初始化流程,也可以手动导入:

ts
import 'virtual:svg-icons/register'

virtual:svg-icons/ids

通过该模块读取当前全部 symbol id:

ts
import ids from 'virtual:svg-icons/ids'

console.log(ids)
// ['icon-icon1', 'icon-icon2', 'icon-dir-icon1', ...]

适用于图标选择器、后台配置页、动态渲染图标等场景。

virtual:svg-icons/sprite

在 SSR 或需要手动拼接 HTML 的场景下,可以读取完整 sprite 字符串:

ts
import sprite from 'virtual:svg-icons/sprite'

详细用法见 服务端渲染(SSR)