Imgix APIsレンダリング APIテキストテキストグラデーションの角度

テキストグラデーションの角度

txt-gradient-angle

txt-gradient-angle パラメーターは、txt-gradient の方向を指定します。グラデーションが有効な場合にのみ読み取られます。

角度はCSSの慣例に従うため、値はグラデーションが向かう先の方向を表します。

角度方向
0下から上
90左から右
180(デフォルト)上から下
270右から左

値は 0 から 360 の整数(度)です。360 を超える値は 360 に丸められます。負の値や小数はデフォルトの 180 に戻り、X-Imgix-Params レスポンスヘッダーからも除外されます。

デフォルトの txt-gradient-angle=180
sandbox-demo
txt-gradient-angle=0 は下から上に向かいます
sandbox-demo
txt-gradient-angle=90 は左から右に向かいます
sandbox-demo
txt-gradient-angle=135 は斜めに向かいます
sandbox-demo

2026年10月13日に角度の定義が変更されました

2026年10月2日から10月13日までは、0 が左から右を意味するデフォルト値で、90 が上から下を意味していました。現在、角度は上記のCSSの慣例に従い、デフォルトは 180 です。既存の txt-gradient のURLはすべて方向が変わります。 以前の見た目を維持するには、以前の角度に90を加えてください。270を超える角度の場合は、代わりに270を引いてください。角度を指定していなかったURLは左から右でしたが、現在は上から下になります。キャッシュされたコピーは有効期限が切れるまで以前の方向のままです。Video API も同日に変更されたため、画像と動画のURLの挙動は揃っています。

このパラメーターはレイヤーごとに機能するため、2つ目のテキストレイヤーには txt-gradient-angle[1] を指定できます。