`
+**Par défaut :** `undefined`
+
-2. Créez un deuxième fichier pour exporter votre implémentation de fournisseur unifont :
+Un objet sérialisable, utilisé pour l'identification.
- ```ts title="implementation.ts"
- import { defineFontProvider } from "unifont";
+#### `init()`
- export const provider = defineFontProvider("mon-fournisseur", async (options, ctx) => {
- // récupérer/définir vos polices personnalisées
- // ...
- });
- ```
+
- :::tip
+**Type :** `(context: FontProviderInitContext) => Awaitable`
+**Par défaut :** `undefined`
+
- Vous pouvez consulter [le code source des fournisseurs d'unifont](https://github.com/unjs/unifont/blob/main/src/providers/) pour en savoir plus sur la création d'un fournisseur unifont.
+Une fonction de rappel optionnelle, utilisée pour exécuter une logique d'initialisation. Son contexte contient un objet `storage`, utile pour la mise en cache.
- :::
+#### `listFonts()`
-3. Ajoutez votre fournisseur personnalisé à votre configuration de police.
+
- ```js title="astro.config.mjs" ins="myProvider()"
- import { defineConfig } from "astro/config";
- import { myProvider } from "./provider/config";
+**Type :** `() => Awaitable`
+**Par défaut :** `undefined`
+
- export default defineConfig({
- experimental: {
+Fonction de rappel optionnelle, utilisée pour retourner la liste des noms de polices disponibles.
+
+### Prendre en charge un registre privé
+
+L'exemple suivant définit un fournisseur de polices pour un registre privé :
+
+```ts title="font-provider.ts"
+import type { FontProvider } from "astro";
+import { retrieveFonts, type Fonts } from "./utils.js",
+
+interface Config {
+ token: string;
+}
+
+export function registryFontProvider(config: Config): FontProvider {
+ let data: Fonts = {}
+
+ return {
+ name: "registry",
+ config,
+ init: async () => {
+ data = await retrieveFonts(token);
+ },
+ listFonts: () => {
+ return Object.keys(data);
+ },
+ resolveFont: ({ familyName, ...options }) => {
+ const fonts = data[familyName];
+ if (fonts) {
+ return { fonts };
+ }
+ return undefined;
+ },
+ };
+}
+```
+
+Vous pouvez ensuite enregistrer ce fournisseur de polices dans la configuration Astro :
+
+```ts title="astro.config.ts"
+import { defineConfig } from "astro/config";
+import { registryFontProvider } from "./font-provider";
+
+export default defineConfig({
+ experimental: {
fonts: [{
- provider: myProvider(),
- // ...
+ provider: registryFontProvider({
+ token: "..."
+ }),
+ name: "Custom",
+ cssVariable: "--font-custom"
}]
- }
- });
- ```
+ }
+});
+```
-