要素をグループに配置する

グループを使用すると、ウォッチフェイスのデザインを論理構造に分割できます。

これは、コンポーネントの整理に役立ちます。各グループに name を指定して、そのグループの目的を示すことができます。

グループが非常に便利なもう 1 つの理由は、グループ内のすべてのものを 1 つのエンティティとして扱い、外観を調整できることです。データソースの変更に合わせて動的に調整することもできます。

以下に、この機能が役立つ場面をいくつかご紹介します。次の Group には、ウォッチフェイスの単一の論理部分を構成するさまざまな PartText, PartImage 要素と PartDraw 要素が含まれています。

<Group name="decorations" x="100" y="100" width="200" height="200">
    <!-- PartText, PartImage, PartDraw elements go here -->
</Group>
watchface_groups.xml

アンビエントの動作を変更する

Group を定義したら、背景モードで Group 全体の可視性を調整できます（たとえば、Group を非表示にするなど）。

<Group name="decorations" x="100" y="100" width="200" height="200">
    <Variant mode="AMBIENT" target="alpha" value="0" />
    <!-- PartText, PartImage, PartDraw elements go here -->
</Group>
watchface_groups.xml

これにより、各子要素に Variant 要素を個別に追加する必要がなくなります。

グループを変換する

アンビエントの動作を調整するのと同様に、Variant を使用すると、Group のプロパティの多くを 1 つ以上の Transform 要素を使用して調整できます。

この例では、Group は秒単位で回転します。pivotX と pivotY を 0.5 として指定すると、Group 内の PartText や PartImage などの各要素の位置に関係なく、Group の中心を中心に回転します。

<Group name="decorations" x="100" y="100" width="200" height="200">
    <!-- One full rotation per minute -->
    <Transform target="angle" value="[SECOND] * 6" />
    <!-- PartText, PartImage, PartDraw elements go here -->
</Group>
watchface_groups.xml