首頁 GitHub

圖片參數

最後更新

本頁列出 GET /c/img/{path} 支援的 query 參數、預設值與優先順序。

參數

參數 別名 值 預設 說明
o origin 1 — 回傳原檔，忽略其他所有參數
s size 整數（px） — 短邊長度，等比例縮放
w width 整數（px） — 寬度
h height 整數（px） — 高度
q quality 0–100 WebP／JPG 75、AVIF 50 輸出品質；PNG 不使用
t type webp／avif／jpg／jpeg／png webp 輸出格式；其他值視為 webp
d dark 1／0 0 找不到圖片時回傳的 404 圖配色

短名與別名同時出現時取短名（?s=200&size=400 取 200）。

優先順序

順序 條件 結果
1 副檔名 .pdf／.svg 直接串流原檔，所有參數無效
2 o=1 直接串流原檔
3 有 s 依短邊縮放，忽略 w／h
4 同時有 w 與 h 裁切至該尺寸
5 只有 w 或 h 依該邊等比例縮放
6 皆無 短邊超過 1024px 時長邊縮至 1024px

各情境的尺寸計算見 尺寸規則。

範例

# 短邊 480px、品質 60、AVIF
curl -fsS -o a.avif "http://localhost:8080/c/img/blog/a.jpg?s=480&q=60&t=avif"

# 裁切為 400x400 的 JPG
curl -fsS -o a.jpg "http://localhost:8080/c/img/blog/a.jpg?w=400&h=400&t=jpg"

# 原檔
curl -fsS -o origin.jpg "http://localhost:8080/c/img/blog/a.jpg?o=1"

# 不存在的圖片，取得深色 404 圖
curl -fsS -o missing.svg "http://localhost:8080/c/img/blog/none.jpg?d=1"
EN