Transformations d'images
Fóir redimensionne et convertit vos images. Un champ image renvoie une URL pour chaque taille nommée dans le format que vous demandez, et l'image derrière une URL est produite la première fois qu'elle est demandée.
Huit tailles nommées
Les tailles sont des préréglages, nommés d'après la largeur du grand côté de l'image en pixels : thumbnail (160), small (640), medium (1024), large (1280), xlarge (1920) et trois niveaux plus grands à 2560, 3840 et 5120. Une source plus petite qu'un niveau n'est pas agrandie pour l'atteindre, et chaque variante indique la largeur et la hauteur auxquelles elle a été rendue.
Quatre formats
WebP est le format par défaut, et AVIF, JPEG et PNG sont disponibles. Vous en choisissez un dans la requête avec variants(format:). Le format fait partie de l'URL et n'est pas négocié à partir de l'en-tête Accept du navigateur, de sorte que chaque URL a une seule représentation. Le client de données place aussi des ensembles WebP et AVIF sur la valeur d'image, et une seule lecture peut alimenter un élément picture.
Rendu à la première requête
L'API remet une URL pour chaque taille et chaque format. L'image est produite quand son URL est demandée pour la première fois, puis servie depuis le cache du CDN. Les instructions voyagent dans un jeton que Fóir émet, de sorte que les paramètres de largeur et de format ajoutés à la main à une URL ne sont pas pris en compte, et une requête que Fóir ne reconnaît pas renvoie l'image d'origine.
Recadrages et points focaux
Un recadrage est un rectangle en pourcentages avec un point focal facultatif, stocké avec l'image là où elle est utilisée. Un fichier de la bibliothèque de médias peut être recadré différemment à chaque endroit où il apparaît.
Placeholders
Au téléversement, Fóir calcule un blurhash et une couleur dominante pour chaque image. Un champ image renvoie les deux avec l'URL, les dimensions et le texte alternatif.
Lire le détail
La référence de l'API média liste les préréglages, les options de format, les champs de recadrage et la forme que renvoie un champ image.