テキストフィットモード
txt-fit
テキストのフィットモードを有効にします。
| 値 | 動作 |
|---|---|
| (未設定) | 1行、境界に収まるようクリップされます(txt-clip を参照)。デフォルト。 |
max | 1行、クリップの代わりに境界内に収まるよう縮小されます。 |
wrap | 複数行に折り返されます。明示的な改行で行が区切られ、行はボックス幅で折り返されます。ボックスの高さに収まらない行は、切り詰められることなく丸ごと省かれます。 |
wrapmax | wrap と同様に折り返された後、ブロック全体が均一に縮小されて収まります。行が失われることはなく、ブロックが拡大されることもありません。 |
その他の値(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 で明示的にオプトインしてください。