Carattere

Fornisce istruzioni sul rendering per uno specifico elemento di testo.

Introdotta in Wear OS 4.

Sintassi

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

Attributi

L'elemento Font ha i seguenti attributi. Alcuni attributi sono obbligatori, mentre altri sono facoltativi.

Attributi obbligatori

I seguenti attributi sono obbligatori:

family

Il nome del carattere utilizzato per visualizzare il testo. Per utilizzare la stessa famiglia di caratteri del sistema, imposta questo valore su SYNC_TO_DEVICE.

Per utilizzare un carattere personalizzato, inserisci il file del carattere in res/fonts/, utilizzando una delle seguenti estensioni accettate per i file dei caratteri: TTF, OTF, TTC o XML. Imposta quindi questo valore sul nome del file del carattere, escludendo l'estensione alla fine.

Se non è possibile risolvere il file del carattere, viene utilizzato il carattere di sistema.

size

Un valore con virgola mobile che specifica le dimensioni del testo.

Attributi facoltativi

I seguenti attributi sono facoltativi:

color
Il colore del testo. Se fornito, devi specificare il colore utilizzando il formato ARGB (#ff000000 = nero opaco) o il formato RGB (#000000 = nero).
letterSpacing
Lo spazio tra le lettere, specificato nelle unità EM. Il valore predefinito è 0. Un esempio di leggera espansione potrebbe essere 0,05. I valori negativi integrino il testo.
slant
Indica se utilizzare un'inclinazione del carattere NORMAL (predefinita) o ITALIC.
width

Un'enumerazione di diversi suggerimenti per una variante della famiglia di caratteri da utilizzare. Il valore predefinito è NORMAL, che applica la variante "normale" del carattere.

L'elenco seguente contiene gli altri valori di enumerazione e le rispettive varianti della famiglia di caratteri che utilizzano, se questa variante è disponibile per il carattere:

  • ULTRA_CONDENSED e EXTRA_CONDENSED utilizzano la variante "luce condensata".
  • CONDENSED utilizza la variante "condensata".
  • SEMI_CONDENSED utilizza la variante "mezzo condensato".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED e ULTRA_EXPANDED utilizzano ciascuno la variante "normale".
weight

Un'enumerazione di diversi spessori di caratteri possibili. Il valore predefinito è NORMAL, che applica una ponderazione di 400.

Il seguente elenco contiene gli altri valori di enumerazione e i rispettivi pesi di carattere:

  • Lo spessore del carattere THIN è 100.
  • Lo spessore del carattere ULTRA_LIGHT è 150.
  • Lo spessore del carattere EXTRA_LIGHT è 200.
  • Lo spessore del carattere LIGHT è 300.
  • Lo spessore del carattere MEDIUM è 500.
  • Lo spessore del carattere SEMI_BOLD è 600.
  • Lo spessore del carattere ULTRA_BOLD è 750.
  • Lo spessore del carattere EXTRA_BOLD è 800.
  • Lo spessore del carattere BLACK è 900.
  • Lo spessore del carattere EXTRA_BLACK è 1000.

Elementi interni

L'elemento Font può contenere i seguenti elementi interni: