עבודה עם טקסט

בשעונים דיגיטליים, מומלץ להשתמש ב-DigitalClock אם אפשר. לכל שאר הטקסט או השעונים שלא ניתן לייצג באמצעות DigitalClock,‏ PartText הוא מאגר התצוגה של טקסט.

בהתאם לסוג הטקסט שרוצים להציג (מעגלי או רגיל), התג PartText צריך להכיל או רכיב Text או רכיב TextCircular.

עבודה עם גופנים וגופני מפת סיביות

שימוש בגופנים מותאמים אישית מאפשר לתצוגת השעון להתבלט עם סגנון משלה.

יש שתי דרכים להשתמש בגופנים בהתאמה אישית, גם בתוך מאגרי התגים TimeText וגם בתוך מאגרי התגים PartText.

מציינים גופן מותאם אישית family ברכיב Font. נתמך מגוון של פורמטים נפוצים, שצריך להציב בתוך res/font

לדוגמה, אם משתמשים בגופן Pacifico מ-Google Fonts וממקמים את הנכס כ-res/font/pacifico.ttf:
```
<PartText x="0" y="50" width="450" height="250">
    <Text align="CENTER">
        <Font family="pacifico" size="96">Hello!</Font>
    </Text>
</PartText>watchface_text.xml
```

אפשרות אחרת היא להגדיר BitmapFont אספקת תמונות bitmap ב-res/drawable:

<BitmapFonts>
    <BitmapFont name="myhandwriting">
        <Character name="1" resource="digit1" width="50" height="100" />
        <Character name="2" resource="digit2" width="50" height="100" />
        <Character name="3" resource="digit3" width="50" height="100" />
        <Character name="4" resource="digit4" width="50" height="100" />
        <!-- ... -->
        <!-- Treat "12" specially, instead of a 1 followed by a 2-->
        <Word name="12" resource="digit12" width="80" height="100" />
    </BitmapFont>
</BitmapFonts>watchface_text.xml

שימו לב איך אפשר לתת יחס מיוחד לרצפים של תווים. לדוגמה, אם רוצים לייצג את המספר 12 באמצעות 1 ו-2 שמחוברים, אפשר לעשות זאת באמצעות רכיב Word.

כדי להשתמש בגופן שהוגדר:

<DigitalClock x="125" y="120" width="200" height="50">
    <TimeText x="0" y="0" width="200" height="50" format="hh:mm">
        <BitmapFont family="myhandwriting" size="48" color="#FF00FF"/>
    </TimeText>
</DigitalClock>watchface_text.xml

אפקטים של טקסט

בפורמט של פני השעון יש כמה אפקטים של טקסט שאפשר להחיל, כמו OutGlow ו-Shadow. כדי להשתמש בהם, צריך להחיל אותם כרכיבי משנה של הרכיב Font:

<Font family="pacifico" size="96" color="#e2a0ff">
    <OutGlow color="#e8ffb7" radius="30">Hello!</OutGlow>
</Font>watchface_text.xml

עבודה עם תבניות

במקום טקסט סטטי, יכול להיות שתצטרכו ליצור את הטקסט ממקורות נתונים או מביטויים.

האלמנט Template מאפשר לכם:

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <Template>Day: %s<Parameter expression="[DAY_OF_WEEK_S]" /></Template>
</Font>watchface_text.xml

עבודה עם משאבים

אם הטקסט הסטטי מוגדר במשאב, למשל ב-res/values/strings.xml, אפשר להפנות אליו באופן הבא:

<!-- greeting defined in res/values/strings.xml -->
<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">greeting</Font>watchface_text.xml

בנוסף, תוכלו להתאים את תצוגת השעון לשפה מסוימת באמצעות מסווגי משאבים שונים.

ריווח בין ידיות

העבודה עם ריווח טקסט ב-XML יכולה להיות מאתגרת. רווחים מיותרים מסביב לטקסט עלולים לגרום לבעיות בפורמט, כמו מיקום לא נכון של הטקסט במרכז, או למנוע מהאפליקציה למצוא משאבי מחרוזות של Android.

כדי להימנע מהמצבים האלה, צריך להוסיף את התוכן של Font לתג CDATA:

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <![CDATA[Hello]]>
</Font>watchface_text.xml

טקסט עם כמה שורות

כדי ליצור טקסט עם כמה שורות, משתמשים במאפיין maxLines ברכיב Text:

<Text align="CENTER" maxLines="2">
    <Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
        <![CDATA[Hello Wear OS world]]>
    </Font>
</Text>watchface_text.xml

עבודה עם טקסט קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.