Откуда файл
С 2020 года браузеры делят кеш по сайтам: Chrome с версии 86, Firefox с 85, Safari — ещё раньше. Файл
с fonts.gstatic.com, скачанный на одном сайте, на другом качается заново, и общий кеш Google Fonts больше
не выигрывает. Свой сервер экономит два соединения — к fonts.googleapis.com за CSS и к fonts.gstatic.com
за файлами, — и читатель не обращается к Google.
Файлы берём у Google Fonts или из пакетов Fontsource и кладём рядом с сайтом. Этот сайт делает так при
сборке: Astro скачивает шрифты, перечисленные в astro.config.mjs, и сам пишет для них CSS.
// astro.config.mjs
fonts: [
{
provider: fontProviders.google(),
name: 'Golos Text',
cssVariable: '--font-golos',
weights: ['400 700'],
styles: ['normal'],
subsets: ['latin', 'cyrillic'],
fallbacks: ['sans-serif'],
},
],
weights: ['400 700'] — диапазон, поэтому Astro берёт вариативный файл. subsets — какие подмножества
скачать: Google отдаёт у Golos ещё latin-ext и cyrillic-ext с буквами других языков, сайту они не нужны.
fallbacks — от чего строить запасной шрифт: для sans-serif Astro подгоняет Arial. CSS вставляет в <head>
компонент <Font cssVariable="--font-golos" />. Ниже этот CSS — без хеша, который Astro добавляет к имени
шрифта.
Файл
@font-face {
font-family: "Golos Text";
src: url("/_astro/fonts/ddd583b46ef3047f.woff2")
format("woff2");
font-weight: 400 700;
font-style: normal;
font-display: swap;
unicode-range: U+0301, U+0400-045F, U+0490-0491,
U+04B0-04B1, U+2116;
}Вариативный файл: font-weight: 400 700 — диапазон, и один файл на 22 КБ отдаёт и текст, и жирные заголовки; без вариативного был бы файл на каждый вес. unicode-range — кириллица: U+0400-045F — буквы вместе с «ё», U+2116 — «№». Браузер качает файл, только если такие знаки есть на странице.
по умолчанию:font-display autounicode-range все знаки
@font-face {
font-family: "Golos Text";
src: url("/_astro/fonts/d911f2505890b67e.woff2")
format("woff2");
font-weight: 400 700;
font-style: normal;
font-display: swap;
unicode-range: U+0000-00FF, U+0131, U+0152-0153,
U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304,
U+0308, U+0329, U+2000-206F, U+20AC, U+2122,
U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}То же имя, другой диапазон: браузер склеивает блоки в один шрифт и для каждого знака берёт свой файл. Латинский файл на 38 КБ нужен и русской странице: в U+0000-00FF — пробел, цифры, знаки препинания и «ёлочки», в U+2000-206F — тире и „лапки“. Поэтому на русской странице Golos — это два файла, 60 КБ.
@font-face {
font-family: "Golos Text fallback";
src: local("Arial");
size-adjust: 103.6337%;
ascent-override: 94.5638%;
descent-override: 21.2286%;
line-gap-override: 0%;
}Запасной шрифт — Arial из системы, подогнанный под Golos: size-adjust растягивает его на 3,6%, чтобы абзац занимал ту же ширину, ascent-override и descent-override дают ту же высоту строки. Пока Golos качается, текст уже стоит на своих местах, и подмена его не сдвигает. Числа Astro считает по метрикам обоих шрифтов — optimizedFallbacks, включено по умолчанию.
по умолчанию:size-adjust 100%ascent-override из шрифта
:root {
--font-golos: "Golos Text", "Golos Text fallback",
sans-serif;
--f-sans: var(--font-golos);
}
body {
font-family: var(--f-sans);
}Порядок: свой шрифт, подогнанный запасной, общий sans-serif — если в системе нет и Arial. Переменную --font-golos объявляет Astro, сайт берёт её через свою --f-sans: другой шрифт для текста — правка одной строки в токенах.
body {
font-synthesis: none;
}Запрещает браузеру дорисовывать недостающие начертания: жирный — утолщением, курсив — наклоном прямых букв. Вместо подделки будет обычный текст, и сразу видно, какого файла не хватает. У Golos Text курсива нет, сайт курсив не использует — поэтому строки здесь нет.
Предзагрузка
<link rel="preload" href="/_astro/fonts/ddd583b46ef3047f.woff2" as="font" type="font/woff2" crossorigin>
Без preload браузер узнаёт о файле поздно: разбирает HTML и CSS, строит страницу и только тогда видит, что
абзацу нужен Golos с кириллицей. С preload загрузка начинается, как только браузер дочитал <head> до этой
строки. crossorigin нужен и для своего домена: шрифты запрашиваются в режиме CORS, и без атрибута
предзагруженный файл не подойдёт — браузер скачает его второй раз.
Предзагружаем одно-два главных начертания: каждый preload делит канал с CSS и картинками первого экрана.
Здесь на русских страницах предзагружены оба файла Golos — латинский нужен абзацу с первого пробела — и кириллица
Unbounded, на английских — латиница:
<Font cssVariable="--font-golos" preload={[{ subset: 'cyrillic' }, { subset: 'latin' }]} />.
Что показывать, пока файл качается
font-display решает, что видит читатель до прихода файла. Числа — рекомендация спецификации CSS Fonts,
браузеры вправе от неё отступать.
| Значение | Пока файл качается | Когда файл пришёл | Когда берём |
|---|---|---|---|
block |
текст невидим, до 3 с | подменяет | шрифт значков: запасной нарисует вместо значка букву |
swap |
сразу запасной шрифт | подменяет, когда бы ни пришёл | текст: читать можно сразу. Так у этого сайта и у Google Fonts со ссылкой display=swap |
fallback |
запасной через 100 мс | подменяет, только если пришёл за 3 с | скачок допустим только в первые секунды |
optional |
запасной через 100 мс | не успел — страница так и остаётся с запасным, файл пригодится на следующей | скачок хуже чужого шрифта |
auto отдаёт выбор браузеру. Astro ставит swap сам: в astro.config.mjs сайта display не задан, а в
собранном CSS — swap. С подогнанным запасным шрифтом подмена почти не двигает текст.
Как проверить
- DevTools, вкладка Network, фильтр Font, перезагрузка без кеша (
Ctrl+Shift+R): на русской странице Golos приходит двумя файлами, около 22 и 38 КБ. Лишних подмножеств нет. - Там же — скорость Slow 4G и перезагрузка: текст виден сразу, а когда шрифт подменяется, строки не переносятся заново и абзацы не сдвигаются.
- Elements, Computed, блок Rendered Fonts внизу — для абзаца на русском там Golos Text, а не Arial.
Если не работает
Шрифт подключили, а на вкладке Network в DevTools файла нет
- Причина
- Имя в
font-familyне совпадает с именем в@font-face— хотя бы пробелом, — или на странице нет ни одного знака изunicode-range: тогда браузер файл не запрашивает. - Делаем
- Сверяем имена. В DevTools — Elements, Computed, блок Rendered Fonts внизу: какой шрифт на деле нарисовал текст.
Файл шрифта качается дважды, в консоли — предупреждение про preload
- Причина
- У
<link rel=preload>нетcrossorigin. Шрифты браузер всегда запрашивает в режиме CORS, и предзагруженный без него файл не подходит. - Делаем
- Добавляем
crossorigin— и для файла со своего же домена.
Шрифт с CDN не грузится, в консоли — ошибка CORS
- Причина
- Файл шрифта с чужого домена браузер берёт, только если сервер ответил заголовком
Access-Control-Allow-Origin. - Делаем
- Ставим заголовок на CDN или раздаём файл со своего домена — тогда CORS не нужен.
Запасной шрифт подогнан, а в Safari при подмене строки всё равно сдвигаются по высоте
- Причина
- Safari понимает
size-adjustс версии 17, аascent-override,descent-overrideиline-gap-override— пока нет: ширина подогнана, высота строки — нет. - Делаем
- Сдвиг по высоте в Safari остаётся. Уменьшает его
preloadосновного файла: чем раньше файл придёт, тем меньше текста успеет отрисоваться запасным.