Fonte

Fornece instruções de renderização para um elemento de texto específico.

Introduzido no Wear OS 4.

Sintaxe

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

Atributos

O elemento Font tem os seguintes atributos. Alguns atributos são obrigatórios, enquanto outros são opcionais.

Atributos obrigatórios

Os seguintes atributos são obrigatórios:

family

O nome da fonte usada para renderizar o texto. Para usar a família de fontes do sistema, defina esse valor como SYNC_TO_DEVICE.

Para usar uma fonte personalizada, coloque o arquivo de fonte em res/fonts/ usando uma das seguintes extensões aceitas: TTF, OTF, TTC ou XML. Em seguida, defina esse valor como o nome do arquivo da fonte, excluindo a extensão no final.

Se o arquivo de fonte não puder ser resolvido, a fonte do sistema será usada.

size

Um valor de ponto flutuante que especifica o tamanho do texto.

Atributos opcionais

Os seguintes atributos são opcionais:

color
É a cor do texto. Se fornecido, especifique a cor usando o formato ARGB (#ff000000 = preto opaco) ou RGB (#000000 = preto).
letterSpacing
O espaço entre as letras, especificado em unidades EM. O valor padrão é 0. Um exemplo de expansão leve pode ser 0,05. Valores negativos reduzem o texto.
slant
Indica a inclinação da fonte NORMAL (padrão) ou ITALIC.
width

Uma enumeração de várias dicas para uma variante de família de fontes usar. O valor padrão é NORMAL, que aplica a variante "normal" da fonte.

A lista a seguir contém os outros valores de enumeração e as respectivas variantes de família de fontes usadas, se essa variante estiver disponível para a fonte:

  • ULTRA_CONDENSED e EXTRA_CONDENSED usam a variante "luz condensada".
  • CONDENSED usa a variante "condensada".
  • SEMI_CONDENSED usa a variante "condensada média".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED e ULTRA_EXPANDED usam a variante "normal".
weight

Uma enumeração de várias espessuras de fonte possíveis. O valor padrão é NORMAL, que aplica uma espessura de 400.

A lista a seguir contém os outros valores de enumeração e as respectivas espessuras de fonte:

  • THIN usa uma espessura de fonte de 100.
  • ULTRA_LIGHT usa uma espessura de fonte de 150.
  • EXTRA_LIGHT usa uma espessura de fonte de 200.
  • LIGHT usa uma espessura de fonte de 300.
  • MEDIUM usa uma espessura de fonte de 500.
  • SEMI_BOLD usa uma espessura de fonte de 600.
  • ULTRA_BOLD usa uma espessura de fonte de 750.
  • EXTRA_BOLD usa uma espessura de fonte de 800.
  • BLACK usa uma espessura de fonte de 900.
  • EXTRA_BLACK usa uma espessura de fonte de 1000.

Elementos internos

O elemento Font pode conter os seguintes elementos internos:

  • Observação: o texto do link aparece quando o JavaScript está desativado.
  • Outline
  • OutGlow
  • Shadow