USS を使用してテキスト文字列全体のスタイルを設定 できますが、テキスト文字列の 1 単語のみをスタイル設定したい場合はどうすればよいでしょうか。これは USS では困難ですが、リッチテキストタグでは簡単です。
リッチテキストタグは、テキスト文字列内に配置してタグ間のテキストのスタイルを設定するためのタグです。
サポートされるすべてのタグについては、サポートされるタグ を参照してください。
ノート: 現在のリリースでは、リッチテキストタグは TextField でサポートされていません。
リッチテキストタグは、HTML タグや XML タグに似ていますが、構文があまり厳しくありません。
単純なタグは名前だけを持つことができ、追加の値や属性を持つことはできません。例えば、<b> タグはテキストを太字にします。
タグの中には、以下のような追加の値や属性を持つものがあります。
<tag="value"><tag attribute="value">例:
<color="red">: テキストを赤にします。<sprite index=3>: デフォルトのスプライトアセットから 4 番目のスプライトを挿入します。ノート: UXML ファイルでは、以下の文字に HTML コードを使用する必要があります。
<: (<)
>: (>)
": (")
以下の表は、使用可能な属性値の種類と値の例を示しています。
| 値の種類 | 値の例 |
|---|---|
| 小数 | 0.5 |
| パーセンテージ | 25% |
| ピクセル値 | 5px |
| フォント単位 | 1.5em |
| Hex カラー値 |
#FFFFFF (RGB)#FFFFFFFF (RGBA)#FF (A) |
| 名前 |
<link=”ID”> と <link=ID> の両方が有効です。 |
タグにはスコープがあり、テキストにどれだけ影響するかを定義します。ほとんどの場合、テキスト内の指定された位置に追加されたタグは、その位置以降のすべてのテキストに影響します。
例えば、タグ <color="red"> をテキストの先頭に追加すると、テキストブロック全体に影響します。<color="red">This text is red
テキストブロックの中央に同じタグを追加すると、タグとブロックの末尾の間のテキストにのみ影響します。This text turns<color="red"> red
テキストブロック内で同じタグを複数回使用する場合は、最後のタグが同じタイプの以前のすべてのタグよりも優先されます。<color="red">This text goes from red<color="green"> to green
終了タグを使用してタグのスコープを制限したり、別のタグ内でネストされたタグを使用したりすることもできます。<color=red>This text is <color=green>mostly </color>red
最初の <color> タグのスコープは、テキストブロック全体です。2 番目の <color> タグには、スコープを 1 つの単語に制限する終了タグがあります。
タグをネストする場合、開始した順序と同じ順序でタグのスコープを閉じる必要はありません。
リッチテキストタグはデフォルトで有効になっています。
リッチテキストタグを無効にするには、以下のいずれかを実行します。
enable-rich-text 属性を false に設定します。