תבנית

מפתחים של תצוגות שעון יכולים לציין פורמט מחרוזות, כמו %s %d. פורמט המחרוזת דומה מאוד ל-printf() בשפה C. או String.format() ב-Java בשפת תכנות.

בנוסף, Template מאפשר למפתח להשתמש במשאבי מחרוזת Android, כולל אלה שהוצהרו ב-res/values/strings.xml.

התכונה הושקה ב-Wear OS 4.

תחביר

<Template>template-string
    <Parameter expression="arithmetic-expression" />
</Template>

דוגמאות

בקטע הקוד הבא אפשר לראות איך להדפיס את המחרוזת Current heart rate: 80 באמצעות הרכיבים Template ו-Parameter:

<Template>%s %d
    <Parameter expression="Current heart rate: " />
    <Parameter expression="[HEART_RATE]" />
</Template>

קטע הקוד הזה מראה איך להשתמש במשאב מחרוזת Android בתוך ביטוי:

<Template>%s<Parameter expression="greeting"></Parameter></Template>

כאשר greeting מוגדר ב-res/values/strings.xml:

<resources>
    <string name="greeting">Hello, world!</string>
</resources>

קטע הקוד הזה מראה איך להשתמש במשאב מחרוזת של Android כדי להדפיס מחרוזת Day: Fri:

<Template>day_of_week
    <Parameter expression="[DAY_OF_WEEK_S]" />
</Template>

כאשר day_of_week מוגדר ב-res/values/strings.xml:

<resources>
    <string name="day_of_week">Day: %1$s</string>
</resources>

אלמנטים פנימיים

הרכיב Template חייב להכיל לפחות רכיב פנימי אחד מסוג Parameter. לרכיב פנימי Parameter יש מאפיין אחד, expression, שהוא מאפיין אריתמטי שהערך שלו מומר לסוג ספציפי לפי מחרוזת הפורמט של הרכיב Template. הביטויים ברמות השונות של Parameter אלמנטים פנימיים מוערכים משמאל לימין בפורמט של הרכיב Template String.