Szablon

Umożliwia deweloperom tarczy zegarka określanie formatu ciągu znaków, np. %s %d. Format ciągu znaków jest bardzo podobny do printf() w języku programowania C lub String.format() w języku programowania Java.

Dodatkowo Template umożliwia deweloperowi używanie zasobów w postaci ciągów znaków dla Androida, w tym tych zadeklarowanych w res/values/strings.xml.

Wprowadzona w Wear OS 4.

Składnia

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

Przykłady

Ten fragment kodu pokazuje, jak wydrukować ciąg znaków Current heart rate: 80 za pomocą elementów Template i Parameter:

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

Ten fragment kodu pokazuje, jak użyć zasobu ciągu tekstowego Androida w wyrażeniu:

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

gdzie greeting jest zdefiniowany w res/values/strings.xml:

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

Ten fragment kodu pokazuje, jak za pomocą zasobu tekstowego Androida wyświetlić ciąg Day: Fri:

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

gdzie day_of_week jest zdefiniowany w res/values/strings.xml:

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

Elementy wewnętrzne

Element Template musi zawierać co najmniej 1 element wewnętrzny Parameter. Element wewnętrzny Parameter ma jeden atrybut – expression, który jest wyrażeniem arytmetycznym, którego wartość jest konwertowana na określony typ zgodnie z ciągiem formatu elementu Template. Wyrażenia w różnych elementach wewnętrznych Parameter są oceniane od lewej do prawej w ciągu formatu elementu Template.