Utilizzare font personalizzati
Questa quida ti mostrerà come aggiungere font web al tuo progetto e usarli nei tuoi componenti.
Astro fornisce un modo per usare i font dal tuo filesystem e da vari fornitori di font (es. Fontsource, Google) attraverso un’API unificata, completamente personalizzabile (EN), e con la sicurezza dei tipi.
I font Web possono influire sulle prestazioni della pagina sia al momento del caricamento che del rendering. Questa API ti aiuta a mantenere il tuo sito performante con ottimizzazioni dei font web automatiche inclusi collegamenti precaricati, alternative ottimizzate, e impostazioni predefinite rigide. Vedere esempi di utilizzo comune.
L’API Fonts si concentra sulle prestazioni e la privacy scaricando e memorizzando nella cache i font così che possano essere serviti al tuo sito. Questo può evitare di inviare i dati degli utenti a siti terzi, e inoltre assicura che un ricco set di font sia disponibile a tutti i tuoi visitatori.
Configurare font personalizzati
Sezione intitolata “Configurare font personalizzati”Si possono registrare font personalizzati per il tuo progetto Astro attraverso l’opzione fonts (EN) nella tua configurazione di Astro.
Per ogni font che vuoi usare, devi specificare il suo nome (EN), una variabile CSS (EN), e un fornitore di font di Astro.
Astro fornisce supporto integrato per i fornitori di font più popolari (EN): Adobe, Bunny, Fontshare, Fontsource, Google, Google Icons e NPM, così come l’utilizzo dei tuoi file di font locali. Inoltre, puoi personalizzare ulteriormente la configurazione del tuo font per ottimizzare le prestazioni e l’esperienza del visitatore.
Usare un file di font locale
Sezione intitolata “Usare un file di font locale”Questo esempio dimostrerà come aggiungere un font personalizzato usando il file di font DistantGalaxy.woff2.
-
Aggiungi il file di font nella cartella
src/, per esempiosrc/assets/fonts/. -
Crea una nuova famiglia di font nel tuo file di configurazione di Astro usando il fornitore di font locale (EN) e specifica le varianti da includere:
astro.config.mjs import { defineConfig, fontProviders } from "astro/config";export default defineConfig({fonts: [{provider: fontProviders.local(),name: "DistantGalaxy",cssVariable: "--font-distant-galaxy",options: {variants: [{src: ['./src/assets/fonts/DistantGalaxy.woff2'],weight: 'normal',style: 'normal'}]}}]}); -
Il tuo font è ora configurato e pronto per essere aggiunto all’head della tua pagina così da poter essere usato nel tuo progetto.
Usare Fontsource
Sezione intitolata “Usare Fontsource”Astro supporta molti fornitori di font (EN) pronti all’uso, includendo il supporto per Fontsource che semplifica l’uso di Google Fonts e altri font open-source.
L’esempio seguente userà Fontsource per aggiungere il supporto a un font personalizzato, ma il processo è simile per tutti i fornitori di font integrati in Astro (es. Adobe, Bunny).
-
Trova il font che vuoi usare nel catalogo di Fontsource. Questo esempio userà Roboto.
-
Crea una nuova famiglia di font nel tuo file di configurazione di Astro usando il fornitore Fontsource (EN):
astro.config.mjs import { defineConfig, fontProviders } from "astro/config";export default defineConfig({fonts: [{provider: fontProviders.fontsource(),name: "Roboto",cssVariable: "--font-roboto",}]}); -
Il tuo font ora è configurato e pronto per essere aggiunto all’head della tua pagina così da poter essere usato nel tuo progetto.
Applicare font personalizzati
Sezione intitolata “Applicare font personalizzati”Dopo che un font è configurato, deve essere aggiunto all’head della tua pagina con una variabile CSS identificativa. Quindi, puoi usare questa variabile quando definisci gli stili della tua pagina.
-
Importa e includi il componente
<Font />(EN) con la proprietà richiestacssVariablenell’head della tua pagina, normalmente in un componente dedicatoHead.astroo direttamente in un componente layout:src/layouts/Layout.astro ---import { Font } from "astro:assets";---<html><head><Font cssVariable="--font-distant-galaxy" /></head><body><slot /></body></html>