Carattere

Fornisce istruzioni di rendering per un elemento di testo specifico.

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 prevede 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 il rendering del 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/font/ utilizzando una delle seguenti estensioni di file di caratteri accettate: TTF, OTF, TTC o XML. Imposta poi questo valore sul nome del file del carattere, esclusa l'estensione alla fine.

Se il file del carattere non può essere risolto, viene utilizzato il carattere di sistema.

size

Un valore in virgola mobile che specifica la dimensione del testo.

Attributi facoltativi

I seguenti attributi sono facoltativi:

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

Un'enumerazione di diversi suggerimenti per l'utilizzo di una variante di famiglia di caratteri. 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 disponibili per il carattere:

  • ULTRA_CONDENSED e EXTRA_CONDENSED utilizzano la variante "condensed-light".
  • CONDENSED utilizza la variante "condensata".
  • SEMI_CONDENSED utilizza la variante "condensed-medium".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED e ULTRA_EXPANDED utilizzano ciascuno la variante "normale".
weight

Un'enumerazione di diversi possibili spessori dei caratteri. Il valore predefinito è NORMAL, che applica un peso di 400.

L'elenco seguente contiene gli altri valori di enumerazione e i rispettivi spessori dei caratteri:

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

Elementi interni

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