גופן

הוראות עיבוד (רנדור) לרכיב טקסט ספציפי.

הוצגה ב-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 משתמש בגרסת 'מוקצעת'.
  • SEMI_CONDENSED משתמש בגרסה 'condensed-medium'.
  • ב-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 יכול להכיל את הרכיבים הפנימיים הבאים: