測定関数
リーフノードのサイズがそのコンテンツ（例：テキスト、画像、プラットフォーム固有のウィジェット）に依存する場合、Taffy はスタイルプロパティのみからサイズを計算できません。このような場合、測定関数を提供する必要があります。
使用タイミング
ツリーがコンテンツベースのサイジングを必要とするノード（例：サイズが "auto" のテキストノード）を含む場合、標準の computeLayout() の代わりに computeLayoutWithMeasure() を使用します。Taffy はコンテンツベースのサイジングを必要とするリーフノードに対してコールバックを呼び出します。
動作原理
測定関数は、レイアウトプロセス中に Taffy が呼び出すコールバックです。「これらの制約が与えられた場合、このコンテンツはどのくらいのサイズですか？」と尋ねます。
引数
knownDimensions: エンジンが今回のコールバックに渡す既知の寸法。既知の値が渡されない軸はundefinedです。レイアウト段階によっては、スタイルに固定サイズがあってもundefinedになります。スタイルの幅・高さをそのままコピーした値ではありません。availableSpace: 各軸の値はピクセル数、"min-content"、"max-content"のいずれかで、今回の測定条件を表します。数値の場合、padding、border、スクロールバー用スペースを差し引いた内容測定用のスペースです。node: 測定対象ノードの ID（bigint）。context:newLeafWithContext()またはsetNodeContext()で関連付けた任意のコンテンツデータ。未設定の場合はundefinedです。style: ノードの現在のスタイルの独立した所有コピー。明示的なグリッド領域の行列数も保持します。使用後に.free()を呼んでください。
通常の newLeaf() で作成したリーフでも測定コールバックは呼ばれます。context は任意のコンテンツデータを渡すためのものです。コールバック内のスタイルコピーを変更してもツリーは更新されません。寸法が確定済みの場合、非表示ノード、キャッシュが使える場合は、コールバックが不要なこともあります。
戻り値
関数は、測定された width と height（ピクセル単位）を含む Size オブジェクトを返す必要があります。
コールバックで発生した例外は現在のバインディングでは外側へ再送出されず、測定値がゼロにフォールバックします。失敗を検知したい場合はコールバック内で捕捉して外部変数などに記録し、computeLayoutWithMeasure() が戻った後に確認してください。
例
典型的なユースケース
- テキストレイアウト: フォントサイズ、テキストコンテンツ、折り返し幅に基づいて幅/高さを計算します。
- 画像: 画像の固有寸法を返します。
- ネイティブ UI ウィジェット: 独自のサイジングロジックを持つプラットフォーム固有のコントロールをラップします。
パフォーマンスのヒント
- 結果をキャッシュ: 測定は高コストになる可能性があります。入力（
knownDimensions、availableSpace、コンテンツ文字列など）に基づいて結果をキャッシュし、同じ測定を再計算することを避けてください。 - 副作用を避ける: 測定関数は純粋である必要があります。その中で DOM や外部状態を変更しないでください。
1 回のレイアウトで同じノードが異なる制約で複数回測定される場合も、キャッシュにより測定されない場合もあります。context の中身を直接書き換えたり、測定関数やフォントを変更したりした場合は、影響するノードに markDirty(node) を呼んでから再計算します。setNodeContext() による更新は自動的にダーティになります。