CKTIS / CSS
format() nel descrittore src di @font-face
`format()` indica il formato atteso di una singola sorgente del font, così il browser può saltare una sorgente non supportata senza scaricarne i dati.
Versione: Current CSS specifications; browser support varies by feature
Sintassi
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, il descrittore src elenca le sorgenti del font in ordine di preferenza, separate da virgole. L’indicazione facoltativa format() segue url() e vale solo per quell’URL. Non segue local(), che identifica una variante del font disponibile localmente.
format() accetta un solo argomento. La specifica preferisce parole chiave come format(woff2), ma per retrocompatibilità accetta anche stringhe precedenti equivalenti, come format("woff2"). Il supporto della sintassi può variare tra browser. tech() è un’indicazione separata per una tecnologia richiesta dal font; se usi entrambe le funzioni, metti tech() dopo format().
Se il browser accetta l’elenco src, la specifica prevede che salti le sorgenti con un formato indicato sconosciuto o non supportato, senza scaricarne i dati. Alcuni browser possono invece scartare l’intero descrittore src quando incontrano un’indicazione che non riconoscono. La capacità di decodificare WOFF2 non garantisce quindi che il browser arrivi a una sorgente WOFF2 più avanti nell’elenco. Senza l’indicazione del formato, esamina i dati quando arriva a quella sorgente. L’indicazione non converte il file e non garantisce che i dati siano validi o che lo scaricamento riesca, per esempio se CORS lo blocca.
Metti la sorgente preferita al primo posto in un unico descrittore src. Se non può usarla, il browser passa alla prossima sorgente che può provare. Indica separatamente una famiglia di riserva nella proprietà font-family, nel caso in cui nessuna sorgente funzioni.
Esempi
<!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>Risultato
Format demo CktisFormatDemo failed to load; using monospace.
Entrambi gli URL `data:` contengono volutamente dati non validi. La dichiarazione `src` precedente mantiene disponibile l’URL WOFF2 se il browser scarta l’elenco successivo durante l’analisi sintattica. Il caricamento di `CktisFormatDemo` non riesce e il testo in `.demo` viene visualizzato con `monospace`. Il risultato non indica quali sorgenti il browser abbia tentato di scaricare.
Lezioni correlate
- CSS · Lezione 14 · Avanzato · Versione: 2
- CSS · Lezione 15 · Avanzato · Versione: 2