功能说明
动态生成占位图片,支持自定义尺寸、背景色与文字颜色。图片中央统一显示其自身尺寸(如 640x480),默认返回 PNG 位图,可直接作为图片资源引用;也支持 SVG 矢量格式(format=svg)。
请求
GET /api/placeholder/{size}
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| size | string | 尺寸,支持 宽x高(如 300x200)或单独 宽(如 400,正方形) |
查询参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| bg | string | cccccc |
背景颜色(6 位十六进制,可带或不带 #) |
| fg | string | 555555 |
文字颜色(6 位十六进制,可带或不带 #) |
| format | string | png |
输出格式,支持 png(默认)或 svg |
| size | string | — | 当路径未提供 size 时,可通过该参数指定(格式同上) |
尺寸上限为
5000x5000,超出将自动截断。
响应
返回 image/png 类型的图片内容,图片中央显示其尺寸,可直接作为图片资源使用:
<img src="/api/placeholder/300x200?bg=eeeeee&fg=333333" />
示例
GET /api/placeholder/300x200
GET /api/placeholder/400
GET /api/placeholder/640x480?bg=1e90ff&fg=ffffff
GET /api/placeholder/800x150?bg=222222&fg=ffcc00
GET /api/placeholder/300x200?size=300x200&bg=c0ffee&format=svg
错误码
- 200 OK
- 400 参数错误(尺寸格式非法、颜色非法、格式不支持)