Modèle

Permet aux développeurs de cadrans de spécifier un format de chaîne, par exemple %s %d. Le format de chaîne est très semblable à printf() en langage de programmation C ou à String.format() en langage de programmation Java.

De plus, Template permet au développeur d'utiliser des ressources de chaîne Android, y compris celles déclarées dans res/values/strings.xml.

Introduit dans Wear OS 4.

Syntaxe

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

Exemples

L'extrait de code suivant montre comment imprimer la chaîne Current heart rate: 80 à l'aide des éléments Template et Parameter :

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

Cet extrait de code montre comment utiliser une ressource de chaîne Android dans une expression :

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

greeting est défini dans res/values/strings.xml :

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

Cet extrait de code montre comment utiliser une ressource de chaîne Android pour imprimer la chaîne Day: Fri :

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

day_of_week est défini dans res/values/strings.xml :

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

Éléments internes

L'élément Template doit contenir au moins un élément Parameter interne. L'élément interne Parameter comporte un attribut, expression, qui est une expression arithmétique dont la valeur est convertie dans un type spécifique en fonction de la chaîne de format de l'élément Template. Les expressions des différents éléments internes Parameter sont évaluées de gauche à droite dans la chaîne de format de l'élément Template.