basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Свой шрифт на сайте: @font-face, кириллица и загрузка без скачка

    Свой шрифт раздаём файлом woff2 со своего сайта: один вариативный файл даёт все веса, кириллица и латиница идут отдельными подмножествами, а запасной шрифт подогнан по метрикам — когда свой догрузится, текст не прыгает. Разбираем по строкам CSS, который для этого сайта собирает Astro.

    Откуда файл

    С 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 добавляет к имени шрифта.

    Файл

    CSS шрифта в <head> страницы
    @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 основного файла: чем раньше файл придёт, тем меньше текста успеет отрисоваться запасным.