Template

Memungkinkan developer tampilan jam menentukan format string, seperti %s %d. Format string sangat mirip dengan printf() dalam bahasa pemrograman C atau String.format() dalam bahasa pemrograman Java.

Selain itu, Template memungkinkan developer menggunakan resource string Android, termasuk yang dideklarasikan dalam res/values/strings.xml.

Diperkenalkan di Wear OS 4.

Sintaksis

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

Contoh

Cuplikan kode berikut menunjukkan cara mencetak string Current heart rate: 80 menggunakan elemen Template dan Parameter:

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

Cuplikan kode ini menunjukkan cara menggunakan resource string Android dalam ekspresi:

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

dengan greeting ditentukan di res/values/strings.xml:

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

Cuplikan kode ini menunjukkan cara menggunakan resource string Android untuk mencetak string Day: Fri:

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

dengan day_of_week ditentukan di res/values/strings.xml:

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

Elemen dalam

Elemen Template harus berisi setidaknya satu elemen dalam Parameter. Elemen dalam Parameter memiliki satu atribut, expression, yang merupakan ekspresi aritmetika yang nilainya dikonversi ke jenis tertentu sesuai dengan string format elemen Template. Ekspresi pada elemen dalam Parameter yang berbeda dievaluasi dari kiri ke kanan dalam string format elemen Template.