글꼴

<ph type="x-smartling-placeholder"></ph>

특정 텍스트 요소의 렌더링 안내를 제공합니다.

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-light' 변형을 사용합니다.
  • CONDENSED는 'condensed' 변형을 사용합니다.
  • SEMI_CONDENSED는 'condensed-medium' 변형을 사용합니다.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED, ULTRA_EXPANDED는 각각 'normal' 변형을 사용합니다.
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 요소는 다음과 같은 내부 요소를 포함할 수 있습니다.