Imgix APIsレンダリング APIテキストテキストフィットモード

テキストフィットモード

txt-fit

テキストのフィットモードを有効にします。

値動作
(未設定)1行、境界に収まるようクリップされます(txt-clip を参照)。デフォルト。
max1行、クリップの代わりに境界内に収まるよう縮小されます。
wrap複数行に折り返されます。明示的な改行で行が区切られ、行はボックス幅で折り返されます。ボックスの高さに収まらない行は、切り詰められることなく丸ごと省かれます。
wrapmaxwrap と同様に折り返された後、ブロック全体が均一に縮小されて収まります。行が失われることはなく、ブロックが拡大されることもありません。

その他の値(wrap,max のような組み合わせも含む)は認識されず、1行にフォールバックします。

txt-pad および txt-width パラメーターを使用して境界領域を制御します。

wrap と wrapmax による複数行テキスト

txt 内で %0A を改行として渡します(txt64 の場合はリテラルな改行)。\r\n は1つの改行としてカウントされ、空行はそのまま保持されます。

https://assets.imgix.net/photo.jpg?w=800&txt=A%20long%20caption%20that%20runs%0Aover%20several%20lines&txt-fit=wrap&txt-width=400&txt-align=middle,center

境界ボックスは、キャンバスから各辺の txt-pad を差し引いたもので、txt-width が設定されている場合はさらに狭められます(単一行テキストの場合と同様に、txt-pad と同じく DPR でスケーリングされます)。txt-x/txt-y はブロックの左上隅を配置し、ボックスはその地点から右下に残ったスペース全体に広がります。txt-align の水平方向の値は各行を揃えてブロックを配置し、垂直方向の値はボックス内でのブロックの配置を決めます。txt-lead がピクセル単位(同じく DPR でスケーリング)で行間を制御します。

折り返されたテキストでは txt-clip は無視されます。ボックスより幅が広い単語は、縮小されるのではなく単語の内部で改行されます(~text エンドポイントと同じルールです)。wrapmax では、それでも収まらない1文字がある場合、どの配置でもボックスに収まるよう縮小されます。CJK テキストは文字ごとに改行され、絵文字はカラーグリフのまま保持されます。

wrap/wrapmax は他のスタイルと同様にレイヤーごとに設定できます — 1つのテキストレイヤーを折り返しにしつつ、別のレイヤーは1行のままにすることも可能です。

動画とはデフォルトが異なります

動画では、Iris はデフォルトでテキストを折り返します。静止画像では、既存の画像 URL の挙動が変わらないよう1行がデフォルトのままです — txt-fit=wrap または txt-fit=wrapmax で明示的にオプトインしてください。