範本

此元素可供錶面開發人員指定 %s %d 這類字串格式。這種格式與 C 程式設計語言中的 printf() 十分雷同,也相當近似於 Java 程式設計語言的 String.format()

此外,Template 允許開發人員使用 Android 字串資源,包括在 res/values/strings.xml 中宣告的資源。

這項元素已在 Wear OS 4 推出。

語法

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

範例

下列程式碼片段說明如何使用 TemplateParameter 元素輸出 Current heart rate: 80 字串:

<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 元素的格式字串轉換為特定類型。系統會在 Template 元素的格式字串中,由左至右逐一評估 Parameter 內部元素中的運算式。