Schriftart

Enthält eine Renderinganleitung für ein bestimmtes Textelement.

In Wear OS 4 eingeführt.

Syntax

<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>

Attribute

Das Font-Element hat die folgenden Attribute: Einige Attribute sind erforderlich, andere sind optional.

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

family

Der Name der Schriftart, die für das Rendern des Texts verwendet wird. Wenn Sie dieselbe Schriftfamilie wie das System verwenden möchten, setzen Sie diesen Wert auf SYNC_TO_DEVICE.

Wenn Sie eine benutzerdefinierte Schriftart verwenden möchten, legen Sie die Schriftdatei in res/font/ ab. Sie muss eine der folgenden zulässigen Dateiendungen haben: TTF, OTF, TTC oder XML. Legen Sie dann diesen Wert auf den Namen der Schriftdatei fest, ohne die Endung am Ende.

Wenn die Schriftdatei nicht aufgelöst werden kann, wird die Systemschriftart verwendet.

size

Ein Gleitkommawert, der die Textgröße angibt.

Optionale Attribute

Die folgenden Attribute sind optional:

color
Die Farbe des Texts. Falls angegeben, muss die Farbe entweder im ARGB-Format (#ff000000 = opakes Schwarz) oder im RGB-Format (#000000 = Schwarz) angegeben werden.
letterSpacing
Der Abstand zwischen Buchstaben, angegeben in EM-Einheiten. Der Standardwert ist 0. Ein Beispiel für eine geringe Ausdehnung wäre 0,05. Negative Werte verdichten den Text.
slant
Ob eine NORMAL-Schrift (Standard) oder eine ITALIC-Schrift verwendet werden soll.
width

Eine Aufzählung mehrerer Hinweise für eine zu verwendende Schriftfamilienvariante. Der Standardwert ist NORMAL, wodurch die „normale“ Variante der Schriftart angewendet wird.

Die folgende Liste enthält die anderen Aufzählungswerte und die zugehörigen Schriftfamilienvarianten, die verwendet werden, sofern diese Variante für die Schrift verfügbar ist:

  • Für ULTRA_CONDENSED und EXTRA_CONDENSED wird die Variante „condensed-light“ verwendet.
  • In CONDENSED wird die „Komprimierte“ Variante verwendet.
  • SEMI_CONDENSED verwendet die Variante „condensed-medium“.
  • Für SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED und ULTRA_EXPANDED wird jeweils die „normale“ Variante verwendet.
weight

Eine Aufzählung mehrerer möglicher Schriftschnitte. Der Standardwert ist NORMAL, was einem Gewicht von 400 entspricht.

Die folgende Liste enthält die anderen Aufzählungswerte und ihre jeweiligen Schriftschnitte:

  • Für THIN wird eine Schriftstärke von 100 verwendet.
  • Für ULTRA_LIGHT wird eine Schriftstärke von 150 verwendet.
  • Für EXTRA_LIGHT wird eine Schriftstärke von 200 verwendet.
  • Für LIGHT wird eine Schriftstärke von 300 verwendet.
  • Für MEDIUM wird eine Schriftstärke von 500 verwendet.
  • Für SEMI_BOLD wird eine Schriftstärke von 600 verwendet.
  • Für ULTRA_BOLD wird eine Schriftstärke von 750 verwendet.
  • Für EXTRA_BOLD wird eine Schriftstärke von 800 verwendet.
  • Für BLACK wird eine Schriftstärke von 900 verwendet.
  • Für EXTRA_BLACK wird eine Schriftstärke von 1000 verwendet.

Innere Elemente

Das Font-Element kann die folgenden inneren Elemente enthalten: