Предоставляет инструкции по отрисовке для определенного текстового элемента.
Представлено в 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
может содержать следующие внутренние элементы: