النموذج

تسمح لمطوّري برامج خلفية شاشة الساعة بتحديد تنسيق سلسلة، مثل %s %d. يشبه تنسيق السلسلة إلى حدٍ كبير printf() في لغة البرمجة C أو String.format() في لغة البرمجة Java.

بالإضافة إلى ذلك، تسمح السمة Template لمطوّر البرامج باستخدام موارد سلاسل Android، بما في ذلك الموارد التي تم تعريفها في res/values/strings.xml.

تم طرح هذه الميزة في Wear OS 4.

بناء الجملة

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

أمثلة

يوضّح مقتطف الرمز التالي كيفية طباعة السلسلة Current heart rate: 80 باستخدام العنصرَين Template وParameter:

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

يعرض مقتطف الرمز هذا كيفية استخدام مورد سلسلة Android داخل تعبير:

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

حيث يتم تحديد greeting في res/values/strings.xml:

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

يوضّح مقتطف الرمز هذا كيفية استخدام مورد سلسلة Android لطباعة السلسلة Day: Fri:

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

حيث يتم تحديد day_of_week في res/values/strings.xml:

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

العناصر الداخلية

يجب أن يحتوي العنصر Template على عنصر Parameter داخلي واحد على الأقل. يحتوي العنصر الداخلي Parameter على سمة واحدة، وهي expression، وهي تعبير حسابي يتم تحويل قيمته إلى نوع محدّد وفقًا لسلسلة تنسيق العنصر Template. يتم تقييم التعبيرات في عناصر Parameter الداخلية المختلفة من اليسار إلى اليمين في سلسلة تنسيق العنصر Template.