فونت

دستورالعمل های رندر برای یک عنصر متنی خاص را ارائه می دهد.

در 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 از نوع "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 می تواند شامل عناصر داخلی زیر باشد:

{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}