Vorlage

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

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

Mit Wear OS 4 eingeführt.

Syntax

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

Beispiele

Das folgende Code-Snippet zeigt, wie der String Current heart rate: 80 mithilfe der Elemente 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-Stringressource in einem Ausdruck verwendet wird:

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

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

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

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

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

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

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

Innere Elemente

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