Шрифт


Предоставляет инструкции по отрисовке для определенного текстового элемента.

Представлено в Wear OS 4.

Синтаксис

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

Атрибуты

Элемент Font имеет следующие атрибуты. Некоторые атрибуты являются обязательными, а другие необязательными.

Обязательные атрибуты

Обязательны следующие атрибуты:

family

Имя шрифта, используемого для отображения текста. Чтобы использовать то же семейство шрифтов, что и в системе, установите для этого значения значение SYNC_TO_DEVICE .

Чтобы использовать собственный шрифт, поместите файл шрифта в res/font/ , используя одно из следующих принятых расширений файла шрифта: TTF, OTF, TTC или XML. Затем установите это значение как имя файла шрифта, исключая расширение в конце.

Если файл шрифта не может быть разрешен, используется системный шрифт.

size

Значение с плавающей запятой, определяющее размер текста.

Дополнительные атрибуты

Следующие атрибуты являются необязательными:

color
Цвет текста. Если он предусмотрен, вы должны указать цвет, используя либо формат ARGB ( #ff000000 = непрозрачный черный), либо формат RGB ( #000000 = черный).
letterSpacing
Пространство между буквами, указанное в единицах EM. Значение по умолчанию — 0. Примером небольшого расширения может быть 0,05. Отрицательные значения сужают текст.
slant
Использовать ли наклон шрифта NORMAL (по умолчанию) или наклон ITALIC .
width

Перечисление нескольких подсказок по использованию варианта семейства шрифтов. Значение по умолчанию — NORMAL , которое применяет «обычный» вариант шрифта.

Следующий список содержит другие значения перечисления и соответствующие варианты семейства шрифтов, которые они используют, если этот вариант доступен для шрифта:

  • ULTRA_CONDENSED и EXTRA_CONDENSED используют вариант «сжатого света».
  • CONDENSED использует «сжатый» вариант.
  • SEMI_CONDENSED использует вариант «сжатой среды».
  • SEMI_EXPANDED , EXPANDED , EXTRA_EXPANDED и ULTRA_EXPANDED используют «нормальный» вариант.
weight

Перечисление нескольких возможных начертаний шрифта. Значением по умолчанию является NORMAL , которому присваивается вес 400 .

Следующий список содержит другие значения перечисления и соответствующую толщину шрифта:

  • THIN использует толщину шрифта 100 .
  • ULTRA_LIGHT использует толщину шрифта 150 .
  • EXTRA_LIGHT использует толщину шрифта 200 .
  • LIGHT использует толщину шрифта 300 .
  • MEDIUM использует толщину шрифта 500 .
  • SEMI_BOLD использует толщину шрифта 600 .
  • ULTRA_BOLD использует толщину шрифта 750 .
  • EXTRA_BOLD использует толщину шрифта 800 .
  • BLACK использует толщину шрифта 900 .
  • EXTRA_BLACK использует толщину шрифта 1000 .

Внутренние элементы

Элемент Font может содержать следующие внутренние элементы:

{% дословно %} {% дословно %} {% дословно %} {% дословно %}