跳至内容
欢迎使用 Web Awesome,这是最大的开源网页组件库。
今天预订!

自行托管 - 网页字体

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

我们将介绍使用网页字体进行设置的基础知识,以及如何使用特定 Font Awesome 图标的 样式

使用网页字体设置

Font Awesome 下载 中,你将找到你需要的所有文件。 /css 文件夹包含所有 Font Awesome 字族(经典、锐利和品牌)以及 样式 选项(实心、常规、浅色、双色调和细线)的核心样式和实用程序。 /webfonts 文件夹包含所有 CSS 文件依赖的字体文件。

在我们的 Pro 下载中,每个版本都有免费版和专业版 - 选择适合你的项目的版本,然后获取这些文件。

哪些文件和文件夹里面有什么
/fontawesome6/pro/webfonts要与 CSS 一起使用的图标作为网页字体
/fontawesome6/pro/css用于使用网页字体的 CSS 文件
/fontawesome6/free/webfonts仅包含要与 CSS 一起使用的免费图标作为网页字体
/fontawesome6/free/css用于仅使用免费网页字体的 CSS 文件

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

/webfonts/css 文件夹复制到你的项目的静态资源目录(或任何你希望保留前端资源或供应商文件的地方)。确保包含核心样式文件 - /css/fontawesome.css - 以及你想要使用的任何单个样式的 CSS 文件,并且你可以删除任何你不打算使用的 .css 和网页字体文件。

将网页字体和 CSS 资源复制到你的项目目录 将网页字体和 CSS 资源复制到你的项目目录之一

以下是一个方便的表格,显示哪些文件与哪些样式一起使用

图标样式可用性网页字体文件名CSS 文件名
品牌免费fa-brands-400.*brands.css
实心免费fa-solid-900.*solid.css
常规仅限专业版fa-regular-400.*regular.css
浅色仅限专业版fa-light-300.*light.css
细线仅限专业版fa-thin-100.*thin.css
双色调仅限专业版fa-duotone-900.*duotone.css
锐利实心仅限专业版fa-sharp-solid-900.*sharp-solid.css
锐利常规仅限专业版fa-sharp-regular-400.*sharp-regular.css
锐利浅色仅限专业版fa-sharp-light-300.*sharp-light.css
锐利细线仅限专业版fa-sharp-thin-100.*sharp-thin.css

在你的项目中引用 Font Awesome

将核心 fontawesome.css 文件以及你想要使用的任何样式的 CSS 文件链接到每个你打算添加图标的模板或页面的 <head> 中。确保路径正确指向你放置文件的位置!

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

<head>
<!-- our project just needs Font Awesome Solid + Brands -->
<link href="/your-path-to-fontawesome/css/fontawesome.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/brands.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/solid.css" rel="stylesheet" />
</head>
<body>
<i class="fa-solid fa-user"></i>
<!-- uses solid style -->
<i class="fa-brands fa-github-square"></i>
<!-- uses brand style -->
</body>

仅此一次,我们建议让事物进入你的头部。

太好了!你已经准备好添加图标了

正如 Anakin 所说,它正在工作!我们所有的 图标 现在都准备好了,可以满足你的项目需求。 了解如何将它们添加到你的项目中,然后利用它们的强大功能为你的 UI 带来秩序和风格!


备用安装:使用 all.css

/css 文件夹中,你可能注意到一个名为 all.css 的文件。此文件包含核心样式和实用程序,以及 Font Awesome 中所有经典样式中的所有图标。(锐利系列不包含在 all.css 文件中 - 你需要单独添加锐利 .css 文件。)

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

如果你想使用 all.css,只需将 /webfonts 文件夹和 /css/all.css 文件复制到你的项目资源目录中,该目录存储其他图像和 CSS。你希望将它们保存在同一个目录中。

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


托管你自己的下载的套件

如果你想承担更重的任务,你可以下载任何 Pro 套件并自行托管!要下载你的套件,确保它是 Pro,并且“设置”中的版本设置为“最新 6.x”或至少 6.4。然后,从你的套件的“设置”选项卡中,你将看到下载选项。

下载的套件中的自定义图标

如果你在你的套件中拥有自定义图标,它们将包含在你的套件下载中。你将发现这些额外文件包含在下载的 zip 中

文件路径文件的用途
/css/custom-icons.css使用网页字体处理自定义图标的显示
/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 预处理器部分,使用网页字体处理自定义图标的显示

这些文件将与 Font Awesome 文件和资源的工作方式相同。如果你正在使用 all.jsall.css,你的自定义图标将包含在其中,但是出于性能原因,我们建议只添加你在项目中使用的文件。

以下是一个使用下载的套件中的锐利实心和自定义图标的示例项目

<head>
<!-- Our project just needs Font Awesome Sharp Solid + our Custom Icons -->
<link href="/your-path-to-fontawesome/css/fontawesome.css" rel="stylesheet" />
<link
href="/your-path-to-fontawesome/css/custom-icons.css"
rel="stylesheet"
/>
<link href="/your-path-to-fontawesome/css/sharp-solid.css" rel="stylesheet" />
</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 兼容性

如果你正在 自行托管 并且 只使用某些样式,请将 css/v5-font-face.css 添加到 html head 中链接的文件中。(all.css 文件默认包含这些实用程序,因此你无需执行任何操作。)

以下是一个示例

<head>
<!-- Loading the v6 core styles and the Solid and Brands styles -->
<link href="/your-path-to-fontawesome/css/fontawesome.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/brands.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/solid.css" rel="stylesheet" />
<!-- update existing v5 CSS to use v6 icons and assets -->
<link href="/your-path-to-fontawesome/css/v5-font-face.css" rel="stylesheet" />
</head>

版本 4 兼容性

如果你的项目包含 Font Awesome 4 图标引用,请将 css/v4-font-face.css 添加到 html head 中链接的文件中。然后,我们的 CSS 将自动将任何 Font Awesome 4 图标名称和 CSS 伪元素 引用转换为版本 6。

<head>
<!-- Add the v6 core styles and then select the individual styles you need, like Solid and Brands -->
<link href="/your-path-to-fontawesome/css/fontawesome.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/brands.css" rel="stylesheet" />
<link href="/your-path-to-fontawesome/css/solid.css" rel="stylesheet" />
<!-- support v4 icon references/syntax -->
<link href="/your-path-to-fontawesome/css/v4-font-face.css" rel="stylesheet" />
</head>

如果您正在使用 all.css,则需要添加 v4-shims.js 文件,该文件将 V4 图标名称映射到最新版本的 Font Awesome 中的图标,如下所示

<head>
<!-- load all Font Awesome v6 styles -->
<link href="/your-path-to-fontawesome/css/all.css" rel="stylesheet" />
<!-- support v4 icon references/syntax -->
<link href="/your-path-to-fontawesome/css/v4-shims.css" rel="stylesheet" />
</head>

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