模板

允许表盘开发者指定字符串格式,例如 %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>

其中 greetingres/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_weekres/values/strings.xml 中定义:

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

内部元素

Template 元素必须包含至少一个 Parameter 内部元素。Parameter 内部元素具有一个属性:expression。这是一个算术表达式,它的值会根据 Template 元素的格式字符串转换为特定类型。不同 Parameter 内部元素中的表达式将在 Template 元素的格式字符串中从左到右进行求值。