Modello

Consente agli sviluppatori di quadranti di specificare un formato stringa, come %s %d. Il formato stringa è molto simile a printf() nel linguaggio di programmazione C o a String.format() nel linguaggio di programmazione Java.

Inoltre, Template consente allo sviluppatore di utilizzare le risorse delle stringhe Android, incluse quelle dichiarate in res/values/strings.xml.

Introdotta in Wear OS 4.

Sintassi

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

Esempi

Il seguente snippet di codice mostra come stampare la stringa Current heart rate: 80 utilizzando gli elementi Template e Parameter:

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

Questo snippet di codice mostra come utilizzare una risorsa stringa Android all'interno di un'espressione:

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

dove greeting è definito in res/values/strings.xml:

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

Questo snippet di codice mostra come utilizzare una risorsa stringa Android per stampare la stringa Day: Fri:

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

dove day_of_week è definito in res/values/strings.xml:

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

Elementi interni

L'elemento Template deve contenere almeno un elemento interno Parameter. L'elemento interno Parameter ha un attributo, expression, ovvero un'espressione aritmetica il cui valore viene convertito in un tipo specifico in base alla stringa di formato dell'elemento Template. Le espressioni nei diversi elementi interni Parameter vengono valutate da sinistra a destra nella stringa di formato dell'elemento Template.