Использование пользовательских шрифтов
Это руководство покажет вам, как добавить веб-шрифты в ваш проект и использовать их в своих компонентах.
Astro предоставляет способ использования шрифтов из файловой системы и различных провайдеров шрифтов (например, Fontsource, Google) через единый, полностью настраиваемый (EN) и типобезопасный API.
Веб-шрифты могут влиять на производительность страницы как во время загрузки, так и во время рендеринга. Этот API помогает сохранять производительность сайта благодаря автоматическим оптимизациям веб-шрифтов, включая ссылки предзагрузки, оптимизированные запасные шрифты продуманные настройки по умолчанию. См. типичные примеры использования.
API шрифтов фокусируется на производительности и конфиденциальности, загружая и кэшируя шрифты таким образом, чтобы они обслуживались с вашего сайта. Это позволяет избежать отправки пользовательских данных на сторонние сайты, а также гарантирует, что согласованный набор шрифтов доступен всем вашим посетителям.
Настройка пользовательских шрифтов
Заголовок раздела «Настройка пользовательских шрифтов»Регистрация пользовательских шрифтов для вашего проекта Astro выполняется через опцию fonts (EN) в конфигурации Astro.
Для каждого шрифта, который вы хотите использовать, необходимо указать его имя (EN), CSS-переменную (EN) и провайдера шрифтов Astro.
Astro предоставляет встроенную поддержку самых популярных провайдеров шрифтов (EN): Adobe, Bunny, Fontshare, Fontsource, Google, Google Icons и NPM, а также использование собственных локальных файлов шрифтов. Кроме того, вы можете дополнительно настроить конфигурацию шрифтов для оптимизации производительности и удобства посетителей.
Использование локального файла шрифта
Заголовок раздела «Использование локального файла шрифта»В этом примере показано добавление пользовательского шрифта с использованием файла шрифта DistantGalaxy.woff2.
-
Добавьте файл шрифта в директорию
src/, например,src/assets/fonts/. -
Создайте новое семейство шрифтов в файле конфигурации Astro, используя локального провайдера шрифтов (EN), и укажите переменные для включения:
astro.config.mjs import { defineConfig, fontProviders } from "astro/config";export default defineConfig({fonts: [{provider: fontProviders.local(),name: "DistantGalaxy",cssVariable: "--font-distant-galaxy",options: {variants: [{src: ['./src/assets/fonts/DistantGalaxy.woff2'],weight: 'normal',style: 'normal'}]}}]}); -
Ваш шрифт настроен и готов к добавлению в заголовок страницы, чтобы его можно было использовать в проекте.
Использование Fontsource
Заголовок раздела «Использование Fontsource»Astro поддерживает несколько провайдеров шрифтов (EN) из коробки, включая поддержку Fontsource, что упрощает использование Google Fonts и других шрифтов с открытым исходным кодом.
В следующем примере для добавления поддержки пользовательского шрифта используется Fontsource, но процесс аналогичен для любого другого встроенного в Astro провайдера (например, Adobe или Bunny).
-
Найдите нужный шрифт в каталоге Fontsource. В этом примере будет использоваться Roboto.
-
Создайте новое семейство шрифтов в файле конфигурации Astro, используя провайдера Fontsource (EN):
astro.config.mjs import { defineConfig, fontProviders } from "astro/config";export default defineConfig({fonts: [{provider: fontProviders.fontsource(),name: "Roboto",cssVariable: "--font-roboto",}]}); -
Ваш шрифт настроен и готов к добавлению в заголовок страницы, чтобы его можно было использовать в проекте.
Применение пользовательских шрифтов
Заголовок раздела «Применение пользовательских шрифтов»После того как шрифт настроен, его необходимо добавить в заголовок страницы с соответствующей CSS-переменной. Затем вы можете использовать эту переменную при определении стилей страницы.
-
Импортируйте и включите компонент
<Font />(EN) с необходимым свойствомcssVariableв заголовок (тег head) вашей страницы, обычно в специализированный компонентHead.astroили непосредственно в компонент макета (layout):src/layouts/Layout.astro ---import { Font } from "astro:assets";---<html><head><Font cssVariable="--font-distant-galaxy" /></head><body><slot /></body></html>