diff --git a/src/content/docs/fr/reference/image-service-reference.mdx b/src/content/docs/fr/reference/image-service-reference.mdx index 3a52930019d82..1b0424593d1e7 100644 --- a/src/content/docs/fr/reference/image-service-reference.mdx +++ b/src/content/docs/fr/reference/image-service-reference.mdx @@ -284,6 +284,33 @@ export default defineConfig({ }); ``` +## Définir un type pour les props personnalisées du service d'images + +

+ +Si votre service d'images prend en charge des propriétés supplémentaires dans le composant `` d'Astro, le composant `` ou la fonction `getImage()`, vous pouvez ajouter des types pour celles-ci en étendant l'interface `Astro.CustomImageProps`. + +Par exemple, pour ajouter une propriété `blur` personnalisée compatible avec votre service d'images : + +```ts +declare namespace Astro { + interface CustomImageProps { + /** Appliquez un flou gaussien avec ce rayon à l'image. */ + blur?: number; + } +} +``` + +Vous pouvez exposer ces types aux utilisateurs en faisant de votre service d'images une [intégration Astro](/fr/reference/integrations-reference/) et en utilisant l'assistant [`injectTypes()`](/fr/reference/integrations-reference/#option-injecttypes). + +Les utilisateurs pourront alors bénéficier de la saisie semi-automatique et de la sûreté du typage pour vos props personnalisées : + +```astro + +// ^^^^^^^^^^ +// Type 'string' is not assignable to type 'number | undefined'. +``` + ## Utilitaires Astro propose plusieurs fonctions d'assistance permettant de développer un service d'images personnalisé. Ces utilitaires peuvent être importés depuis `astro/assets/utils` : diff --git a/src/content/docs/fr/reference/integrations-reference.mdx b/src/content/docs/fr/reference/integrations-reference.mdx index 3e7175d071622..d6c401f030146 100644 --- a/src/content/docs/fr/reference/integrations-reference.mdx +++ b/src/content/docs/fr/reference/integrations-reference.mdx @@ -674,7 +674,7 @@ Une copie en lecture seule de la [configuration Astro](/fr/reference/configurati Transforme l'intégration en adaptateur. Pour en savoir plus, consultez l'[API des adaptateurs](/fr/reference/adapter-reference/). -#### Options `injectTypes()` +#### Option `injectTypes()`