模板

允许表盘开发者指定字符串格式，例如 %s %d。字符串格式与 C 编程语言中的 printf() 或 Java 编程语言中的 String.format() 非常相似。

此外，Template 允许开发者使用 Android 字符串资源，包括在 res/values/strings.xml 中声明的资源。

在 Wear OS 4 中引入。

语法

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

示例

以下代码片段展示了如何使用 Template 和 Parameter 元素打印字符串 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 元素的格式字符串转换为特定类型。不同 Parameter 内部元素中的表达式在 Template 元素的格式字符串中从左到右求值。