Bildtransformationen
Fóir skaliert und konvertiert Ihre Bilder. Ein Bildfeld gibt für jede benannte Größe eine URL im angeforderten Format zurück, und das Bild hinter einer URL wird beim ersten Abruf erzeugt.
Acht benannte Größen
Größen sind Presets, benannt nach der Breite der langen Bildkante in Pixeln: thumbnail (160), small (640), medium (1024), large (1280), xlarge (1920) und drei größere Stufen mit 2560, 3840 und 5120. Eine Quelle, die kleiner als eine Stufe ist, wird nicht darauf vergrößert, und jede Variante meldet die Breite und Höhe, mit der sie gerendert wurde.
Vier Formate
WebP ist die Voreinstellung, und AVIF, JPEG und PNG sind verfügbar. Sie wählen eines in der Abfrage mit variants(format:). Das Format ist Teil der URL und wird nicht aus dem Accept-Header des Browsers ausgehandelt, sodass jede URL genau eine Darstellung hat. Der Data-Client legt außerdem WebP- und AVIF-Sets auf den Bildwert, und ein Lesezugriff kann ein Picture-Element füllen.
Beim ersten Abruf gerendert
Die API gibt für jede Größe und jedes Format eine URL aus. Das Bild wird erzeugt, wenn seine URL zum ersten Mal abgerufen wird, und danach aus dem Cache des CDN ausgeliefert. Die Anweisungen reisen in einem Token, das Fóir ausstellt, sodass von Hand an eine URL angehängte Breiten- und Formatparameter nicht berücksichtigt werden und eine Query, die Fóir nicht erkennt, das Originalbild zurückgibt.
Zuschnitte und Fokuspunkte
Ein Zuschnitt ist ein Rechteck in Prozent mit einem optionalen Fokuspunkt, gespeichert mit dem Bild dort, wo es verwendet wird. Eine Datei aus der Asset-Bibliothek kann an jeder Stelle, an der sie erscheint, anders zugeschnitten werden.
Platzhalter
Beim Upload berechnet Fóir für jedes Bild einen Blurhash und eine dominante Farbe. Ein Bildfeld gibt beides zusammen mit der URL, den Abmessungen und dem Alt-Text zurück.
Details nachlesen
Die Media-API-Referenz listet die Presets, die Formatoptionen, die Zuschnittsfelder und die Form auf, die ein Bildfeld zurückgibt.