Vorlage

Ermöglicht Zifferblattentwicklern, ein Stringformat wie %s %d anzugeben. Das Stringformat ist printf() in der Programmiersprache C oder String.format() in der Programmiersprache Java sehr ähnlich.

Außerdem ermöglicht Template dem Entwickler die Verwendung von Android-String-Ressourcen, einschließlich der in res/values/strings.xml deklarierten.

Eingeführt in Wear OS 4.

Syntax

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

Beispiele

Das folgende Code-Snippet zeigt, wie der String Current heart rate: 80 mit den Elementen Template und Parameter ausgegeben wird:

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

Dieses Code-Snippet zeigt, wie eine Android-String-Ressource in einem Ausdruck verwendet wird:

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

wobei greeting in res/values/strings.xml definiert ist:

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

Dieses Code-Snippet zeigt, wie Sie mit einer Android-String-Ressource den String Day: Fri ausgeben:

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

wobei day_of_week in res/values/strings.xml definiert ist:

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

Innere Elemente

Das Template-Element muss mindestens ein Parameter-Element enthalten. Das innere Parameter-Element hat ein Attribut, expression, bei dem es sich um einen arithmetischen Ausdruck handelt, dessen Wert gemäß dem Formatstring des Template-Elements in einen bestimmten Typ konvertiert wird. Die Ausdrücke in den verschiedenen inneren Parameter-Elementen werden im Formatstring des Template-Elements von links nach rechts ausgewertet.