Skip to main content

色彩調色盤

可在配置中參考的可重複使用色彩集合。

屬性

default - object、選用。十六進位色彩定義的集合,可使用色彩參考來參考。 highContrast - object、選用。十六進位色彩定義的集合,可使用色彩參考來參考。啟用高對比模式時,會覆寫 default 中的定義。

範例

上述配置在高對比模式停用時: 色彩調色盤且高對比模式停用的觸控配置 以及在高對比模式啟用時: 色彩調色盤且高對比模式啟用的觸控配置

備註

上述範例包含覆寫系統色彩 (例如 system_contentPrimary、system_accentPrimary 等) 的色彩定義,以及自訂色彩定義 (myColor1、myColor2)。控制項在設定樣式時會隱含地取樣系統色彩,這表示任何覆寫都會影響所有控制項的全域樣式 (除非控制項在自訂 styles 區塊中有自己的覆寫)。自訂色彩必須使用色彩參考 (例如 colors/myColor1) 明確地參考。此外,自訂色彩定義不能使用保留的 system_ 前置詞,因為它保留給系統色彩使用。 色彩定義宣告在 default 和 highContrast 物件中,並分別在高對比模式停用或啟用時啟動。高對比模式停用時,色彩會從 default 取樣。啟用時,色彩會先從 highContrast 取樣,如果不存在定義,則回復為 default。如果 default 中沒有系統色彩覆寫,則會使用系統預設值,而自訂色彩則必須在 default 中定義。下表概述上述色彩定義會如何根據高對比 (HC) 模式是否啟用而解析:

系統色彩

下表摘要列出觸控調整套件中的系統色彩清單、它們用於設定控制項樣式的方式說明,以及高對比 (HC) 模式停用/啟用時的系統預設值。 如需最新清單,請參閱最新結構描述中前置詞為 _SystemColor 的定義。

另請參閱

觸控調整套件參考
觸控調整配置的高對比模式
Last modified on October 6, 2026