跳到主要内容

文档

自定义图标

UIkit 的图标库可以使用你自己的图标文件来扩展和定制。

UIkit 的图标库中包含许多 SVG 图标,它们被打包在单个 JavaScript 文件 uikit-icons.min.js 中。该文件包含所有图标,无需额外的 SVG 文件。本文档介绍如何向该库添加自己的图标,或覆盖已有的图标。默认图标的概览请参见 Icon 组件。


添加与覆盖图标

你可以覆盖 UIkit 的任意默认图标,并创建额外的图标。准备工作:请先从 GitHub 源码搭建 UIkit。现在你就可以添加自己的 SVG 图标,并把它们纳入 UIkit 的构建流程。

构建流程会在两个位置查找额外的图标文件:

编译 UIkit 以包含这些额外的图标:

pnpm compile

你添加的图标现在会被加入图标库,存放在以下两个位置之一:


避免命名冲突

如果你创建的图标使用了已有的名称,就会覆盖同名的默认图标。例如,/custom/icons/close.svg 会覆盖默认的 close 图标。

如果你的图标使用了此前未被占用的名称,它就会作为新图标被添加。例如,/custom/icons/example.svg 会创建一个新图标,可以通过 <span uk-icon="example"></span> 使用。

要检查哪些名称已被占用,请查看 /src/images/components 和 /src/images/icons 这两个目录。创建新图标时,确保这两个文件夹中都没有使用相同的名称。否则,它会覆盖已内置的图标。