模板

允许表盘开发者指定字符串格式，例如 %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 元素的格式字符串中从左到右进行求值。