Schriftart

Stellt Rendering-Anweisungen für ein bestimmtes Textelement bereit.

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

Merkmale

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

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

family

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

Wenn du eine benutzerdefinierte Schriftart verwenden möchtest, lege die Schriftartdatei im Verzeichnis res/fonts/ ab. Verwende dazu eine der folgenden zulässigen Dateiendungen für Schriftarten: TTF, OTF, TTC oder XML. Legen Sie dann diesen Wert auf den Namen der Schriftartdatei ohne die Endung am Ende fest.

Wenn die Schriftartdatei 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 Textes. Falls angegeben, musst du die Farbe im ARGB-Format (#ff000000 = opaken Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.
letterSpacing
Das Leerzeichen zwischen den Buchstaben, angegeben in EM-Einheiten. Der Standardwert ist 0. Eine leichte Erweiterung könnte zum Beispiel 0,05 sein. Negative Werte verschärfen den Text.
slant
Gibt an, ob eine NORMAL-Schriftneigung (Standardeinstellung) oder eine ITALIC-Neigung verwendet werden soll.
width

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

Die folgende Liste enthält die anderen Aufzählungswerte und die von ihnen verwendeten Varianten der Schriftfamilie, sofern diese Variante für die Schriftart verfügbar ist:

  • ULTRA_CONDENSED und EXTRA_CONDENSED verwenden die Variante „kondensed-light“.
  • CONDENSED verwendet die komprimierte Variante.
  • SEMI_CONDENSED verwendet die Variante „komprimiert-mittel“.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED und ULTRA_EXPANDED verwenden jeweils die "normale" Variante.
weight

Aufzählung verschiedener möglicher Schriftstärken Der Standardwert ist NORMAL, wodurch eine Gewichtung von 400 angewendet wird.

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

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

Innere Elemente

Das Font-Element kann die folgenden inneren Elemente enthalten: