UIkit 的图标库可以使用你自己的图标文件来扩展和定制。
UIkit 的图标库中包含许多 SVG 图标,它们被打包在单个 JavaScript 文件 uikit-icons.min.js 中。该文件包含所有图标,无需额外的 SVG 文件。本文档介绍如何向该库添加自己的图标,或覆盖已有的图标。默认图标的概览请参见 Icon 组件。
你可以覆盖 UIkit 的任意默认图标,并创建额外的图标。准备工作:请先从 GitHub 源码搭建 UIkit。现在你就可以添加自己的 SVG 图标,并把它们纳入 UIkit 的构建流程。
构建流程会在两个位置查找额外的图标文件:
/custom/icons/*.svg/custom/mytheme/icons/*.svg编译 UIkit 以包含这些额外的图标:
pnpm compile你添加的图标现在会被加入图标库,存放在以下两个位置之一:
dist/js/uikit-icons.js,前提是你把图标添加到了 UIkit 全局dist/js/uikit-icons-mytheme.js,前提是图标只位于某个 UIkit 主题中如果你创建的图标使用了已有的名称,就会覆盖同名的默认图标。例如,/custom/icons/close.svg 会覆盖默认的 close 图标。
如果你的图标使用了此前未被占用的名称,它就会作为新图标被添加。例如,/custom/icons/example.svg 会创建一个新图标,可以通过 <span uk-icon="example"></span> 使用。
要检查哪些名称已被占用,请查看 /src/images/components 和 /src/images/icons 这两个目录。创建新图标时,确保这两个文件夹中都没有使用相同的名称。否则,它会覆盖已内置的图标。