データ型(キャラクターディスプレイ)

データ型(キャラクターディスプレイ)

ここでは、APL-Tで使用できるデータ型について説明します。

APL-Tでは、APLデータ型のすべてがサポートされるわけではありません。たとえば、ColorGradientFilterはサポートされません。

ディメンション

APL-Tのディメンションは、絶対、相対、特殊の3種類で表されます。

絶対ディメンション

絶対ディメンションはシンプルな数値で、必要に応じて修飾子を含めることができます。修飾子の指定がない場合、絶対ディメンションは画面文字単位と見なされます。有効な修飾子は次のとおりです。

名前 説明
ch 画面文字単位を表します。
vh ビューポートの高さの1%を表します。100vhがviewport.heightに相当します。
vw ビューポートの幅の1%を表します。100vwがviewport.widthに相当します。

相対ディメンション

相対ディメンションは、「X%」という形式の文字列です。Xは有効なJSON数値です。パーセンテージのディメンションは、包含側のコンポーネントのバウンディングボックスに対する割合として解釈されます。バウンディングボックスには2つのディメンション(幅と高さ)があるため、本質的に水平方向または垂直方向を意味するプロパティ(paddingTop、heightなど)では、それに応じた適切なディメンションが選択されます。

パーセンテージのディメンションを使用すると依存関係ループが発生し、結果が未定義になる可能性があることに注意してください。たとえば、親コンテナーのサイズが「auto」の場合に子の高さを「50%」に設定すると、結果は未定義になります。APL-Tランタイムは画面へのレンダリングを試みますが、異なるデバイス間で一貫したレンダリングエクスペリエンスが提供される保証はありません。

特殊ディメンション

特殊ディメンションは、特別な処理が設定された名前付きの値です。現在定義されている特殊ディメンションは「auto」のみです。このディメンションでは、コンポーネントのサイズは自然なサイズと等しくなります。たとえば、幅と高さが「auto」のTextコンポーネントは、そのテキストだけを含む単一行のバウンディングボックスに配置されます。


このページは役に立ちましたか?

最終更新日: 2025 年 12 月 17 日