Schriftart

Liefert Rendering-Anweisungen für ein bestimmtes Textelement.

Eingeführt in Wear OS 4.

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 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 Rendering des Textes verwendet wird. Wenn Sie dieselbe Schriftfamilie wie das System verwenden möchten, legen Sie für diesen Wert SYNC_TO_DEVICE fest.

Wenn Sie eine benutzerdefinierte Schriftart verwenden möchten, fügen Sie die Schriftartdatei mit einer der folgenden zulässigen Dateiendungen für Schriftarten in res/fonts/ ein: TTF, OTF, TTC oder XML. Legen Sie dann diesen Wert auf den Namen der Schriftartdatei ohne die Erweiterung am Ende fest.

Wenn die Schriftartdatei nicht aufgelöst werden kann, wird die Systemschrift verwendet.

size

Ein Gleitkommawert, der die Textgröße angibt.

Optionale Attribute

Die folgenden Attribute sind optional:

color
Die Farbe des Textes. Falls vorhanden, musst du die Farbe entweder im ARGB-Format (#ff000000 = deckendes Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.
letterSpacing
Das Leerzeichen zwischen Buchstaben, angegeben in EM-Einheiten. Der Standardwert ist 0. Ein Beispiel für eine leichte Ausweitung könnte 0,05 sein. Durch negative Werte wird der Text optimiert.
slant
Gibt an, ob eine NORMAL-Schriftneigung (Standard) oder eine ITALIC-Neigung verwendet werden soll.
width

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

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

  • Für ULTRA_CONDENSED und EXTRA_CONDENSED wird die Variante für „kondensiertes Licht“ verwendet.
  • CONDENSED verwendet die komprimierte Variante.
  • SEMI_CONDENSED verwendet die Variante „komprimiert mittel“.
  • Für SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED und ULTRA_EXPANDED wird jeweils die „normale“ Variante verwendet.
weight

Eine Aufzählung mehrerer möglicher Schriftstärken. Der Standardwert ist NORMAL mit einer Gewichtung von 400.

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

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

Innere Elemente

Das Font-Element kann die folgenden Elemente im Inneren enthalten:

  • Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
  • Umriss
  • Glow
  • Schatten