自定义图标

UIkit 的图标库可以使用您自己的图标文件进行扩展和自定义。

UIkit 的图标库包含许多 SVG 图标，捆绑在一个 JavaScript 文件 uikit-icons.min.js 中。此文件包含所有图标，不需要额外的 SVG 文件。在本文件中，我们将介绍如何将您自己的图标添加到此库或覆盖现有的图标。查看 图标组件 以了解默认图标的概述。

添加和覆盖图标

您可以覆盖 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 将覆盖默认的关闭图标。

如果您的图标使用以前从未使用过的名称，它将被添加为新图标。例如，/custom/icons/example.svg 将创建一个新的图标，可以通过 <span uk-icon="example"></span> 使用。

要检查哪些名称已在使用，请查看两个目录 /src/images/components 和 /src/images/icons。在创建新图标时，请确保这两个文件夹中都不使用相同的名称。否则，它将覆盖包含的图标。