BooleanConfiguration

布林值設定可在錶面編輯器中,為使用者提供可開啟或關閉的錶面自訂選項。

這項元素已在 Wear OS 4 推出。

語法

<BooleanConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="TRUE | FALSE"
/>

您可以在 Scene 元素內加入 BooleanConfiguration 元素,如以下程式碼片段所示:

<UserConfigurations>
  <BooleanConfiguration id="show_date"
      displayName="show_date_label"
      screenReaderText="show_date_label"
      defaultValue="TRUE"
  />
</UserConfigurations>

<!-- ... -->

<Scene backgroundColor="#ff000000">
  <!-- ... -->

  <BooleanConfiguration id="show_date">
    <BooleanOption id="TRUE">
      <Group ...>
        <!-- ...Content to show date -->
      </Group>
    </BooleanOption>
    <BooleanOption id="FALSE">
      <Group ...>
        <!-- ...Content when date not required -->
      </Group>
    </BooleanOption>
  </BooleanConfiguration>

  <!-- ... -->
</Scene>

屬性

BooleanConfiguration 元素的屬性如下:

必要屬性

必要屬性包括:

id
設定值的專屬 ID。
displayName
與錶面編輯器所顯示文字相對應的資源 ID。
defaultValue
如果使用者未明確變更錶面編輯器中的設定,系統會使用預設值。

選用屬性

選用屬性包括:

icon
與顯示的可繪製資源相對應的資源 ID 錶面編輯器大小上限為 400x400 像素。
screenReaderText
與使用者所使用文字相對應的資源 ID 已啟用 TalkBack
,瞭解如何調查及移除這項存取權。