CKTIS / CSS
format() w deskryptorze src reguły @font-face
`format()` określa oczekiwany format pojedynczego źródła fontu. Przeglądarka może dzięki temu pominąć nieobsługiwane źródło bez pobierania jego danych.
Wersja: Current CSS specifications; browser support varies by feature
Składnia
src = <font-src>#
<font-src> = <url> [ format( <font-format> ) ]? [ tech( <font-tech># ) ]? | local( <font-family-name> )
<font-format> = <string> | collection | embedded-opentype | opentype | svg | truetype | woff | woff2W regule @font-face deskryptor src podaje listę źródeł fontu w kolejności preferencji, rozdzielonych przecinkami. Opcjonalne format() umieszcza się po url() i dotyczy ono tylko tego adresu. Nie dodaje się go do local(), które wskazuje lokalnie dostępną odmianę fontu.
format() przyjmuje jeden argument. Specyfikacja preferuje słowa kluczowe, np. format(woff2), ale dla zgodności wstecznej akceptuje też m.in. równoważne format("woff2"). Obsługa składni może zależeć od przeglądarki. tech() to osobna wskazówka dotycząca wymaganej technologii fontu; jeśli używasz obu funkcji, tech() umieść po format().
Jeśli przeglądarka zaakceptuje listę src, zgodnie ze specyfikacją pomija źródła o nieznanym lub nieobsługiwanym formacie bez pobierania ich danych. Niektóre przeglądarki mogą jednak odrzucić cały deskryptor src po napotkaniu nierozpoznanej wskazówki. Sama obsługa WOFF2 nie gwarantuje więc, że przeglądarka dotrze do późniejszego źródła WOFF2 na tej liście. Bez wskazówki o formacie ocenia dane, gdy dojdzie do danego źródła. Wskazówka nie konwertuje pliku ani nie gwarantuje, że dane są poprawne lub że pobranie się powiedzie, np. przy blokadzie CORS.
Umieść preferowane źródło jako pierwsze w jednym src. Jeśli nie da się go użyć, przeglądarka przechodzi do następnego źródła, które może wypróbować. Oddzielnie podaj rodzinę zapasową we właściwości font-family, na wypadek gdyby żadne źródło nie zadziałało.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Font format hint demo</title>
<style>
@font-face {
font-family: "CktisFormatDemo";
/* Keep the WOFF2 URL available if the next declaration is invalid. */
src: url("data:font/woff2,second-invalid-payload") format("woff2");
src: url("data:font/woff2,first-invalid-payload") format("cktis-unknown-format"),
url("data:font/woff2,second-invalid-payload") format("woff2");
}
.demo {
font-family: "CktisFormatDemo", monospace;
}
</style>
<body>
<div class="demo">Format demo</div>
<div id="result" role="status"></div>
<script type="module">
const demo = document.querySelector('.demo');
const result = document.querySelector('#result');
const src = document.styleSheets[0].cssRules[0].style.getPropertyValue('src');
const loadFailed = await document.fonts.load('16px "CktisFormatDemo"', demo.textContent)
.then(() => false, () => true);
await document.fonts.ready;
const families = getComputedStyle(demo).fontFamily.split(',').map(name => name.trim());
const fallbackIsMonospace = families.length === 2 &&
families[0].replace(/["']/g, '') === 'CktisFormatDemo' &&
families[1] === 'monospace';
result.textContent = src.includes('second-invalid-payload') && loadFailed && fallbackIsMonospace
? 'CktisFormatDemo failed to load; using monospace.'
: 'Unexpected result: check the src descriptor, font load, and fallback family.';
</script>
</body>
</html>Wynik
Format demo CktisFormatDemo failed to load; using monospace.
Oba adresy `data:` celowo zawierają niepoprawne dane. Wcześniejsza deklaracja `src` zachowuje adres WOFF2 na wypadek, gdyby przeglądarka odrzuciła późniejszą listę podczas analizy składni. Font `CktisFormatDemo` nie zostaje wczytany, a tekst w `.demo` jest wyświetlany krojem z rodziny `monospace`. Ten wynik nie pozwala ustalić, które źródła przeglądarka próbowała pobrać.
Powiązane lekcje
- CSS · Lekcja 14 · Zaawansowany · Wersja: 2
- CSS · Lekcja 15 · Zaawansowany · Wersja: 2