Поиск

Как подключить Font Awesome

Как подключить Font Awesome

Font Awesome можно подключить тремя способами: положить CSS и шрифты на свой сервер, добавить официальный Kit или установить пакет через npm. После подключения укажите стиль и имя иконки, например fa-solid fa-download. Чтобы проверить оба класса и увидеть рисунок, откройте «Иконки Font Awesome» и найдите нужное действие по русскому слову или техническому имени.

Как найти класс нужной иконки

В каталоге введите «скачать», download или класс из вашего проекта. В карточке выберите формат HTML и скопируйте готовую строку. В fa-solid fa-download первая часть выбирает стиль, вторая — значок. Для доступных контурных вариантов применяют fa-regular, для фирменных знаков — fa-brands. Проверьте, что нужная иконка есть именно в выбранном стиле и версии.

ИщетеТехническое имяКласс в Free
Скачиваниеdownloadfa-solid fa-download
Поискmagnifying-glassfa-solid fa-magnifying-glass
Настройкиgearfa-solid fa-gear
Контурное сердцеheartfa-regular fa-heart
Знак GitHubgithubfa-brands fa-github

В старых проектах можно встретить короткие префиксы fas, far, fab и прежние имена вроде fa-home. При переносе проекта сверьте версию подключённого набора и найдите актуальное имя. Для нового примера выберите fa-solid fa-house. Оба класса удобнее копировать вместе, особенно если рядом используются варианты разных стилей.

Три способа подключения

1. Локальные CSS и Web Fonts

Скачайте дистрибутив Font Awesome Free для веба. В папку статических файлов перенесите css и webfonts рядом друг с другом. Подключите базовый CSS и стили, которые используете. Для карточки скачивания хватит Solid. Для контурного сердца дополнительно понадобится Regular. Когда в проекте уже подключён all.min.css из того же набора, отдельные файлы стилей дублируют его правила.

<link rel='stylesheet' href='/assets/fontawesome/css/fontawesome.min.css'>
<link rel='stylesheet' href='/assets/fontawesome/css/solid.min.css'>

<button type='button'>
<i class='fa-solid fa-download' aria-hidden='true'></i>
Скачать отчёт
</button>

Для Regular добавьте regular.min.css, для Brands — brands.min.css. Проверьте, что файлы шрифтов для этих стилей тоже попали на сервер. Если сайт устанавливается в подкаталог, путь, начинающийся с /assets, ведёт от корня домена. Укажите тот URL, по которому ваш сервер действительно отдаёт статические файлы.

2. Официальный Kit

В учётной записи Font Awesome создайте Kit и выберите нужную версию и доступный набор. Возьмите выданный код вставки и добавьте его в шаблон страниц. Затем используйте иконки с соответствующими классами. Если Kit настроен на SVG + JS, он может заменять исходные элементы на SVG. У CSS-подключения через шрифты HTML остаётся прежним, рисунок формирует стиль.

Для актуальной версии официальный удалённый способ — Kit. Старый Font Awesome CDN обслуживает версии до пятой включительно. Если проект уже использует стороннее CDN-зеркало, проверьте точную версию, наличие стилей и адрес шрифта. Для воспроизводимой сборки закрепите версию и используйте один согласованный источник ассетов.

3. Пакет npm

В проекте со сборщиком установите бесплатный пакет @fortawesome/fontawesome-free. Импортируйте CSS в уже существующую точку входа. Сборщик должен перенести шрифты в каталог результата и исправить ссылки на них. Название и стиль в HTML остаются такими же.

npm install @fortawesome/fontawesome-free

import '@fortawesome/fontawesome-free/css/all.min.css';

Первая строка выполняется в терминале, импорт добавляется в JavaScript или TypeScript. В рабочем проекте проверьте файл блокировки зависимостей и сборку для размещения на сервере. Иконка может работать при локальной разработке и пропасть после размещения, если путь к статическим ресурсам отличается.

Почему после переноса папки webfonts появляется 404

Браузер вычисляет относительный url(...) внутри CSS от адреса самого файла CSS. Если стиль доступен по /assets/fontawesome/css/solid.min.css, ссылка ../webfonts/fa-solid-900.woff2 ведёт к /assets/fontawesome/webfonts/fa-solid-900.woff2. Перенос стилей в /assets/css меняет расчёт пути. Копирование одной папки CSS приводит к тому же результату, если старый адрес шрифтов остался в правилах.

  1. Откройте инструменты разработчика и вкладку Network. Отфильтруйте загрузки шрифтов и перезагрузите страницу.
  2. Сверьте полный адрес загружаемого файла WOFF2 со структурой опубликованной папки. На хостинге может учитываться регистр имён.
  3. Восстановите соседние папки дистрибутива или пересоберите CSS с действующим путём к шрифту. Повторите проверку с отключённым кэшем во время открытых инструментов.
  4. Если по адресу шрифта возвращается HTML с кодом 200, проверьте переадресацию на страницу сайта. После исправления по адресу должен приходить файл шрифта.

Когда CSS и шрифт загрузились, а иконка по-прежнему пустая, сравните классы и выбранное начертание. Например, класс Brands требует своего стиля. Подробную диагностику можно продолжить по инструкциям «Иконки Font Awesome пропали» и «WOFF2 не загружается».

Проверьте подключение на двух знакомых иконках из разных стилей. Например, покажите рядом залитую шестерёнку и контурное сердце. Если видна шестерёнка, а вместо сердца квадрат, сначала посмотрите наличие Regular. Если по стилям всё верно, сравните версии локального CSS и файла WOFF2. При обновлении библиотеки заменяйте файлы из одного дистрибутива и учитывайте, что CDN и браузер могут ещё хранить прежний CSS.

На вкладке Elements выделите элемент с классами и посмотрите, применились ли правила Font Awesome. При подходе Web Fonts рисунок часто виден в псевдоэлементе ::before. Если правило отсутствует, проверьте, подключён ли соответствующий CSS и правильно ли написано имя. Если псевдоэлемент есть, но рисунок пустой, посмотрите семейство и вес шрифта в вычисленных стилях. Например, глобальное правило для i может переопределять эти свойства.

Размер шрифтовой иконки удобно задать через font-size. Проверьте её вместе с соседней надписью, потому что длина строки и высота кнопки меняются при увеличении текста. Если кнопка состоит только из рисунка, задайте доступное название самой кнопке, например «Скачать отчёт».

Что делать дальше

  1. Подключите один способ и откройте тестовую кнопку «Скачать отчёт». Проверьте, видны ли значок, подпись и фокус с клавиатуры.
  2. Для игрового инвентаря сравните отдельный набор RPG Awesome с фэнтези-символами и экспортом SVG.
  3. Если для проекта нужны авторские иллюстрации в той же палитре, найдите подходящий пример в каталоге промтов для графики.
—
20:51
69
Нет комментариев. Ваш будет первым!