CKTIS / CSS
format() in de src-descriptor van @font-face
`format()` geeft het verwachte formaat van één lettertypebron aan. Zo kan de browser een niet-ondersteunde bron overslaan zonder de gegevens op te halen.
Versie: Current CSS specifications; browser support varies by feature
Syntax
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 | woff2In @font-face bevat de descriptor src een kommagescheiden lijst van lettertypebronnen in volgorde van voorkeur. De optionele formaataanwijzing format() staat na url() en geldt alleen voor die URL. Ze staat niet na local(), waarmee je een lokaal beschikbare lettertypevariant aanduidt.
format() neemt één argument. De specificatie geeft de voorkeur aan trefwoorden zoals format(woff2), maar accepteert voor achterwaartse compatibiliteit ook gelijkwaardige oudere tekenreeksen zoals format("woff2"). Ondersteuning voor de syntaxis kan per browser verschillen. Met tech() geef je apart een vereiste lettertypetechnologie aan. Als je beide functies gebruikt, zet je tech() na format().
Als de browser de src-lijst accepteert, slaat hij volgens de specificatie bronnen met een onbekende of niet-ondersteunde formaataanwijzing over zonder hun gegevens op te halen. Sommige browsers kunnen in plaats daarvan de hele src-descriptor verwerpen zodra ze een aanwijzing tegenkomen die ze niet herkennen. Dat een browser WOFF2 kan decoderen, garandeert dus niet dat hij een WOFF2-bron verderop in die lijst bereikt. Zonder zo’n aanwijzing beoordeelt de browser de gegevens zodra die bron aan de beurt is. De aanwijzing converteert het bestand niet en garandeert niet dat de gegevens geldig zijn of dat het ophalen lukt, bijvoorbeeld als CORS het blokkeert.
Zet de voorkeursbron bovenaan in één src-descriptor. Kan de browser die niet gebruiken, dan gaat hij naar de volgende bron die hij kan proberen. Geef daarnaast in de eigenschap font-family een terugvalfamilie op voor het geval geen enkele bron werkt.
Voorbeelden
<!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>Resultaat
Format demo CktisFormatDemo failed to load; using monospace.
Beide `data:`-URL’s bevatten opzettelijk ongeldige gegevens. De eerdere `src`-declaratie houdt de WOFF2-URL beschikbaar als de browser de latere lijst bij het parsen verwerpt. Het laden van `CktisFormatDemo` mislukt en de tekst in `.demo` wordt weergegeven met `monospace`. Dit resultaat laat niet zien welke bronnen de browser heeft geprobeerd op te halen.
Gerelateerde lessen
- CSS · Les 14 · Gevorderd · Versie: 2
- CSS · Les 15 · Gevorderd · Versie: 2