ドキュメント

画像リサイズ

画像URLにパラメータを付与することでオリジナル画像には変更を加えずに画像のリサイズ、クオリティ変更を行うことができます。

設定できるパラメータ

  • w: 幅指定(10単位。端数は繰り上げ)
  • h: 縦指定(10単位。端数は繰り上げ)
  • q: クオリティ。hのみ許可

画像リサイズを有効にするには、w / hいずれかのパラメータ設定が必須となります。w / hのパラメータがない場合、リサイズせずにオリジナルの画像を返します。

パラメータサンプル

  • ?w=400 : 幅のみ指定
  • ?w=640&h=400&q=h : 全て指定

画像リサイズの仕様詳細

  • オリジナルより小さくなる場合のみ変換します。パラメータでの画像サイズ指定が同じ、もしくは大きい場合は、オリジナル画像を返します。
  • アスペクト比は固定です。w / hの大きい方にマッチしたサイズで画像を返します。

クオリティの仕様詳細

  • デフォルトでは画像クオリティを80(最大100)としています。
  • クオリティの指定はh(ハイクオリティ・画像クオリティ90)のみ許可しています。

対応フォーマット

  • jpg
  • png
  • webp

webpは、ブラウザの Accept ヘッダーを確認し、対応しているブラウザに対して自動的に変更します。

画像リサイズサンプル

オリジナル画像

https://files.hacocms.com/5/media/29/1652/ogp.png

幅を200pxにリサイズ

https://files.hacocms.com/5/media/29/1652/ogp.png?w=200

高さを200pxにリサイズ

https://files.hacocms.com/5/media/29/1652/ogp.png?h=200