跳至内容
欢迎 Web Awesome,最大的开源 Web 组件库。
今天预订!

自行托管 - SVG + JS

如果您喜欢控制,您可以自行托管 Font Awesome,并且可以选择使用下面描述的 SVG + JS 或Web 字体 + CSS 将图标添加到您的项目中。

使用 SVG+JS 设置

Font Awesome 下载 中,您会找到所需的文件。的 /js 文件夹包含所有 Font Awesome 的 系列(Classic、Sharp 和 Brands)以及 样式 选项(Solid、Regular、Light、Duotone 和 Thin)的核心样式、实用程序和图标。

在我们的 Pro 下载中,有一个 Free 和 Pro 文件夹 - 选择适合您的项目的那个,并从那里获取文件。

哪些文件和文件夹那里有什么
/fontawesome6/pro/js每个样式的图标和脚本,或一次性所有样式。
/fontawesome6/free/js仅每个样式的免费图标和脚本。

将 Font Awesome 文件添加到您的项目中

fontawesome.js 加载程序和要使用的样式的 .js 文件复制到项目的静态资产目录(或您喜欢保存前端资产或供应商内容的任何位置)。务必包含核心文件 - /js/fontawesome.js - 以及要使用的任何单个样式的 JS 文件。

将您需要的核心文件和特定样式文件复制到您的项目目录 将您需要的核心文件和特定样式文件复制到您的项目目录

这是一个方便的表格,显示哪个文件对应于哪个样式

图标样式可用性JS 文件名
品牌免费brands.jsbrands.min.js
实心免费solid.jssolid.min.js
常规仅 Proregular.jsregular.min.js
浅色仅 Prolight.jslight.min.js
细线仅 Prothin.jsthin.min.js
双色调仅 Produotone.jsduotone.min.js
锐利实心仅 Prosharp-solid.jssharp-solid.min.js
锐利常规仅 Prosharp-regular.jssharp-regular.min.js
锐利浅色仅 Prosharp-light.jssharp-light.min.js
锐利细线仅 Prosharp-thin.jssharp-thin.min.js

在您的项目中引用 Font Awesome

将核心 fontawesome.js 文件以及要使用的任何样式的 JS 文件链接到您计划添加图标的每个模板或页面的 <head> 中。我们建议最后引用 fontawesome.js 加载程序。确保路径正确指向您放置文件的位置!

这是一个示例 html 页面,其中 <head> 中包含文件链接,内容中包含几个图标。

<head>
<!-- Our project just needs Font Awesome Solid + Brands -->
<script defer src="/your-path-to-fontawesome/js/brands.js"></script>
<script defer src="/your-path-to-fontawesome/js/solid.js"></script>
<script defer src="/your-path-to-fontawesome/js/fontawesome.js"></script>
</head>
<body>
<i class="fa-solid fa-user"></i>
<!-- uses solid style -->
<i class="fa-brands fa-github-square"></i>
<!-- uses brand style -->
</body>

仅此一次,我们建议让事情进入您的脑海。

Yuss!您已准备好添加图标

就像阿纳金说的,它正在工作!我们所有的 图标 现在已准备好按照您的项目的要求行事。了解如何将它们添加到您的项目中,然后使用它们的强大功能为您的 UI 带来秩序和风格!


备用安装:使用 all.js

/js 文件夹中,您可能注意到一个名为 all.js 的文件。此文件包含核心样式和实用程序 PLUS Font Awesome 中所有 Classic 样式中的所有图标。(Sharp 系列不包含在 all.js 文件中 - 您需要单独使用 Sharp .js 文件。)

如果您将使用所有图标样式或在开发项目时测试不同的样式,这是一个方便的文件。但是,如果您只使用几个样式,我们不建议将其用于生产站点,因为加载所有图标不利于性能。

如果您想使用 all.js,只需将其复制到项目的静态资产目录中,或者您喜欢保存前端资产或供应商内容的任何位置。

然后,将 /your-path-to-fontawesome/js/all.js 文件的链接添加到您想要使用 Font Awesome 图标的每个模板或页面的 <head> 中。


托管您自己的下载的工具包

从 6.4 版开始,您现在可以下载工具包并自行托管,就像您使用 Font Awesome 一样!要下载您的工具包,确保设置中的工具包版本设置为“最新 6.x”,或者如果您选择了特定版本,它需要至少为 6.4。然后,从工具包的“设置”选项卡中,您将看到用于下载的选项。

下载的工具包中的自定义图标

如果您在工具包中拥有自定义图标,它们将包含在您的工具包下载中。您会发现这些附加文件包含在下载的 zip 中

到文件的路径文件的作用
/css/custom-icons.css使用 Web 字体处理自定义图标的显示
/js/custom-icons.js /js/custom-icons.min.js使用 SVG+JS 处理自定义图标的显示
/sprites/custom-icons.svg所有自定义图标都在一个 SVG 雪碧图中
/svgs/custom-icons/包含所有自定义图标作为 SVG 的文件夹
/webfonts/custom-icons.woff /webfonts/custom-icons.ttf自定义图标字体,格式为 WOFF2 和 TTF
/scss/custom-icons.scss/less/custom-icons.lessSass (SCSS) 和 Less 预处理器部分,用于使用 Web 字体处理自定义图标的显示

这些文件将与 Font Awesome 文件和资产一样工作。如果您使用的是 all.jsall.css,您的自定义图标将包含在其中,尽管出于性能原因,我们建议仅添加项目中使用的文件。

这是一个使用下载的工具包中的 Sharp Solid 和自定义图标的示例项目

<head>
<!-- Our project just needs Font Awesome Sharp Solid + our Custom Icons -->
<script defer src="/your-path-to-fontawesome/js/sharp-solid.js"></script>
<script defer src="/your-path-to-fontawesome/js/custom-icons.js"></script>
<script defer src="/your-path-to-fontawesome/js/fontawesome.js"></script>
</head>
<body>
<!-- uses sharp solid style -->
<i class="fa-sharp fa-solid fa-user"></i>
<!-- uses Kit custom icon style -->
<i class="fa-kit fa-your-custom-icon-name"></i>
</body>

使用工具包自定义图标非常简单。


旧版本兼容性

如果您的项目使用的是旧版本的 Font Awesome,我们提供了向后兼容性 的支持。这意味着您无需更新项目中的任何图标名称 - 我们会自动转换任何旧版本图标名称、样式语法和 CSS 伪元素图标引用。以下是为需要支持的先前版本启用该支持的方法

5 版兼容性

加载后,我们的 SVG + JS 框架会自动处理转换任何 Font Awesome 5 图标名称、样式语法和 CSS 伪元素图标引用。当使用 js/all.js 文件或仅使用某些样式 时,情况就是这样。

4 版兼容性

如果您的项目包含 Font Awesome 4 图标引用,请在包含的任何 v6 JS 文件后添加 v4-shims.js 文件。该文件将映射 v4 图标名称到 Font Awesome 最新版本中的图标。

这是一个示例

<head>
<!-- Add the v6 core styles and then select the individual styles you need, like Solid and Brands -->
<script defer src="/your-path-to-fontawesome/js/fontawesome.js"></script>
<script defer src="/your-path-to-fontawesome/js/solid.js"></script>
<script defer src="/your-path-to-fontawesome/js/brands.js"></script>
<!-- support v4 icon references/syntax -->
<script defer src="/your-path-to-fontawesome/js/v4-shims.js"></script>
</head>

如果您需要更多帮助将现有项目升级到更新版本的 Font Awesome,请查看我们的升级指南