フォント

特定のテキスト要素のレンダリング手順を提供します。

Wear OS 4 で導入されました。

構文

<Font family="string | SYNC_TO_DEVICE" size="float"
      color="argb-color | rgb-color" slant="NORMAL | ITALIC"
      letterSpacing="em-value"
      width="ULTRA_CONDENSED | EXTRA_CONDENSED | CONDENSED | SEMI_CONDENSED |
             NORMAL | SEMI_EXPANDED | EXPANDED | EXTRA_EXPANDED |
             ULTRA_EXPANDED"
      weight="THIN | ULTRA_LIGHT | EXTRA_LIGHT | LIGHT | NORMAL | MEDIUM |
              BOLD | SEMI_BOLD | ULTRA_BOLD | EXTRA_BOLD | BLACK | EXTRA_BLACK">
    <!-- Inner elements consist of text decoration and text formatting
         options. Here, "Lower" is used as an example. -->
    <Lower ... />
</Font>

属性

Font 要素には次の属性があります。必須の属性もあれば、省略可能な属性もあります。

必須属性

次の属性は必須です。

family

テキストのレンダリングに使用されるフォントの名前。システムと同じフォント ファミリーを使用するには、この値を SYNC_TO_DEVICE に設定します。

カスタム フォントを使用するには、フォント ファイルを res/fonts/ に配置します。使用できるフォント ファイル拡張子（TTF、OTF、TTC、XML）のいずれかを使用します。次に、この値をフォント ファイルの名前（末尾の拡張子を除く）に設定します。

フォント ファイルを解決できない場合は、システム フォントが使用されます。

size

テキストサイズを指定する浮動小数点値。

オプションの属性

次の属性は省略可能です。

color
テキストの色。指定する場合は、ARGB 形式（#ff000000 = くすんだ黒）または RGB 形式（#000000 = 黒）を使用して色を指定する必要があります。
letterSpacing
文字間のスペース。EM 単位で指定します。デフォルト値は 0 です。わずかに拡張する場合の例は 0.05 です。負の値を指定すると、テキストを引き締めます。
slant
NORMAL フォントの傾斜（デフォルト）と ITALIC の傾斜、どちらを使用するか。
width

フォント ファミリーのバリエーションを使用する際のヒントを列挙したものです。デフォルト値は NORMAL で、フォントの「normal」バリエーションを適用します。

他の列挙値と、それぞれが使用するフォント ファミリーのバリエーション（フォントで利用可能な場合）のリストを以下に示します。

  • ULTRA_CONDENSED と EXTRA_CONDENSED は「condensed-light」バリエーションを使用します。
  • CONDENSED は「condensed」バリエーションを使用します。
  • SEMI_CONDENSED は「condensed-medium」バリエーションを使用します。
  • SEMI_EXPANDED、EXPANDED、EXTRA_EXPANDED、ULTRA_EXPANDED のそれぞれが「normal」バリエーションを使用します。
weight

可能なフォントの太さを列挙します。デフォルト値は NORMAL で、400 の太さが適用されます。

他の列挙値と各フォントの太さは以下のとおりです。

  • THIN のフォントの太さは 100 です。
  • ULTRA_LIGHT のフォントの太さは 150 です。
  • EXTRA_LIGHT のフォントの太さは 200 です。
  • LIGHT のフォントの太さは 300 です。
  • MEDIUM のフォントの太さは 500 です。
  • SEMI_BOLD のフォントの太さは 600 です。
  • ULTRA_BOLD のフォントの太さは 750 です。
  • EXTRA_BOLD のフォントの太さは 800 です。
  • BLACK のフォントの太さは 900 です。
  • EXTRA_BLACK のフォントの太さは 1000 です。

内部要素

Font 要素には次の内部要素を含められます。