图像转换

Fóir 会调整和转换你的图像。图像字段按你要求的格式为每个命名尺寸返回一个 URL,URL 背后的图像在第一次被请求时生成。

八种命名尺寸

尺寸是预设,以图像长边的像素宽度命名:thumbnail(160)、small(640)、medium(1024)、large(1280)、xlarge(1920),以及 2560、3840 和 5120 的三个更大档位。小于某档位的源图不会被放大去适应它,每个变体都会报告其渲染时的宽度和高度。

四种格式

WebP 是默认格式,也可以使用 AVIF、JPEG 和 PNG。你在查询中用 variants(format:) 选择其一。格式是 URL 的一部分,不会根据浏览器的 Accept 标头协商,因此每个 URL 只有一种表示。数据客户端还会在图像值上放置 WebP 和 AVIF 集合,一次读取就能填充一个 picture 元素。

首次请求时渲染

API 为每种尺寸和格式给出一个 URL。图像在其 URL 首次被请求时生成,之后由 CDN 缓存提供。指令包含在由 Fóir 签发的令牌中,因此手动添加到 URL 上的宽度和格式参数不会生效,Fóir 无法识别的查询会返回原始图像。

裁剪与焦点

裁剪是以百分比表示的矩形,可带一个可选的焦点,与图像一起存储在使用它的位置。同一个来自资源库的文件,可以在它出现的每个位置以不同方式裁剪。

占位符

上传时,Fóir 会为每张图像计算 blurhash 和主色。图像字段会连同 URL、尺寸和替代文本一并返回这两者。

了解详情

媒体 API 参考列出预设、格式选项、裁剪字段,以及图像字段返回的形状。