Text
概要
<Text> は、横書きのテキストを描画する要素です。
この要素では、描画したい文字列をテキストコンテンツとして指定します。 テンプレート変数をテキストコンテンツ内で使用することも可能です。 詳細については、以下の開発ガイドを参照してください。
XMLの記述例
レイアウトXML
<Text>これはTextです。</Text>
このXMLは以下のように描画されます。
スタイルXML
<Text key="style1" fontFamily="mincho" />
属性
fontFamily
フォントファミリーを設定します。
- データ型
- FontFamily
- 必須
- 省略可能です。既定値は
gothicです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
size
フォントサイズを設定します。
指定可能な値は 1 以上、1024 以下です。
- データ型
- UnsignedFloat （単位 : pt）
- 必須
- 省略可能です。既定値は
11です。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
color
テキストの色を設定します。
- データ型
- Color
- 必須
- 省略可能です。既定値は
blackです。 - テンプレート変数の使用
- 使用可能です。
- スタイルXMLでの記述
- 記述可能です。
bold
テキストを太字にするかを設定します。
- データ型
- Boolean
- 必須
- 省略可能です。既定値は
falseです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
underline
テキストに下線を引くかを設定します。
- データ型
- Boolean
- 必須
- 省略可能です。既定値は
falseです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
underlinePosition
下線の描画位置を設定します。
- データ型
- UnderlinePosition
- 必須
- 省略可能です。既定値は
normalです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
lineGap
テキストの垂直方向の行間を設定します。
size を基準にした相対サイズを指定します。
例えば、<Text size="11" lineGap="0.5"> と指定した場合、 5.5ポイント分の行間を設けてテキストが描画されます。
- データ型
- UnsignedFloat
- 必須
- 省略可能です。既定値は
0です。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
letterSpacing
テキストの水平方向の字間を設定します。
size を基準にした相対サイズを指定します。
例えば、<Text size="11" letterSpacing="0.5"> と指定した場合、 5.5ポイント分の字間を設けてテキストが描画されます。
- データ型
- UnsignedFloat
- 必須
- 省略可能です。既定値は
0です。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
align
テキストの水平方向の配置を設定します。
align="justify" と letterSpacing を同時に指定した場合、 letterSpacing よりも広い字間となるように両端揃えを行います。
- データ型
- TextAlign
- 必須
- 省略可能です。既定値は
leftです。 - テンプレート変数の使用
- 使用可能です。
- スタイルXMLでの記述
- 記述可能です。
valign
テキストの垂直方向の配置を設定します。
- データ型
- TextVerticalAlign
- 必須
- 省略可能です。既定値は
topです。 - テンプレート変数の使用
- 使用可能です。
- スタイルXMLでの記述
- 記述可能です。
wordwrap
テキストの折り返し方法を設定します。
- データ型
- Wordwrap
- 必須
- 省略可能です。既定値は
normalです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
overflow
テキストが描画領域内に収まらなかった場合の振る舞いを設定します。
- データ型
- Overflow
- 必須
- 省略可能です。既定値は
clipです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述可能です。
width
描画領域の幅を設定します。
注記
この属性はスタックルールの要素内でのみ使用できます。
- データ型
- UnsignedFloat （単位 : mm）
- 必須
- 必須です。
- テンプレート変数の使用
- 使用可能です。
- スタイルXMLでの記述
- 記述できません。
height
描画領域の高さを設定します。
- データ型
- FlexHeight （単位 : mm）
- 必須
- 省略可能です。既定値は
autoです。 - テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述できません。
style
この要素に適用するスタイルの名前を設定します。
- データ型
- StyleName
- 必須
- 省略可能です。既定値はありません。
- テンプレート変数の使用
- 使用できません。
- スタイルXMLでの記述
- 記述できません。