Windows 終端機中的主題設定 (預覽)
下列設定會影響終端機視窗本身的視覺效果,而不是個別索引標籤/窗格的外觀。 這些設定目前只能在 settings.json 檔案中直接編輯,而且無法透過設定 UI 進行設定。
"theme": "dark"
"themes":
[
// THEME OBJECTS
]
如需一些範例主題,請參閱主題資源庫。
themes
清單中的每個主題,都是由屬性物件的集合所組成,這些物件會指定應用程式個別元素的屬性。 例如,預設的 "dark"
主題如下:
{
"name": "dark",
"window": {
"applicationTheme": "dark"
},
"tab": {
"background": "terminalBackground",
"unfocusedBackground": "#00000000"
},
"tabRow": {
"unfocusedBackground": "#333333FF"
}
},
您也可以將終端機設定為使用個別主題來對應 OS 中的淺色和深色模式,並且在 OS 主題變更時自動變更這些主題。 若要這麼做,請將 theme
屬性指定為包含索引鍵 light
和 dark
的物件:
"theme": { "dark": "<Dark Theme Name>", "light": "<Light Theme Name>" },
主題名稱
這是主題的名稱。 名稱不得重複。 名稱 dark
、light
和 system
會保留給內建的預設主題。
屬性名稱:name
必要性:必要
接受:以字串表示的主題名稱
視窗
這些設定是用來設定終端機整個視窗的外觀。
屬性名稱:window
應用程式佈景主題
這會設定應用程式的 UI 佈景主題。 這會設定按鈕、命令調色盤和其他應用程式 UI 元素項目的風格。 主題可以是淺色或深色。 "system"
將使用與 Windows 相同的佈景主題。
屬性名稱:applicationTheme
必要性: 選用
接受:"system"
、"dark"
、"light"
預設值:"dark"
Mica
這會在此視窗及其底下的所有其他 UI 層啟用 Mica效果。 若要讓 Mica 可見,其上方的 UI 層必須為透明。 例如,若要在其中使用含有 Mica 的索引標籤列,則您需要將背景的 Alpha 色板設定為 0
,如下所示:
{
"name": "My Mica Theme",
"tab":
{
"background": "terminalBackground"
},
"tabRow":
{
"background": "#00000000"
},
"window":
{
"applicationTheme": "system",
"useMica": true
}
},
請注意,當您為視窗啟用 Mica 時,會在整個視窗底下啟用,包括視窗中作為終端機窗格的底圖。 這表示使用 opacity
而未啟用 useAcrylic
的設定檔,將會顯示在新的 Mica 背景上。 目前不可能同時具有終端機的未透明背景,以及Tabs /Tab 列的Mica背景。
屬性名稱:useMica
必要性: 選用
接受:true
、false
預設值:false
注意
Mica 僅適用於 Windows 組建 >= 22621。
視窗框線
這會設定視窗在使用中的視窗框線色彩。 當設定為 null
,框線將使用 OS 主題的預設色彩。
屬性名稱:frame
必要性: 選用
接受:主題色彩
預設值:null
注意
視窗框線色彩僅適用於 Windows 11。
重要
這項功能僅適用於 Windows 終端機預覽。
非使用中視窗的框線
這會設定視窗在非使用中的視窗框線色彩。 當設定為 null
,框線將使用 OS 主題的預設色彩。
屬性名稱:unfocusedFrame
必要性: 選用
接受:主題色彩
預設值:null
重要
這項功能僅適用於 Windows 終端機預覽。
實驗性:彩虹視窗框線
此設定啟用時,將會使視窗框線循環顯示彩虹色彩。 這是實驗性功能,並不保證其持續存在。 啟用此設定時,其優先順序會高於 frame
和 unfocusedFrame
。
屬性名稱:experimental.rainbowFrame
必要性: 選用
接受:true
、false
預設值:false
重要
這項功能僅適用於 Windows 終端機預覽。
索引標籤列
這些設定可用來設定索引標籤列的外觀。 當 showTabsInTitlebar
為 true
(此為預設值),這會設定標題列。
屬性名稱:tabRow
背景色彩
視窗在前景時,索引標籤列的色彩。
屬性名稱:background
必要性: 選用
接受:主題色彩。
非使用中背景色彩
視窗在非使用中的時候,索引標籤列的色彩。
屬性名稱:unfocusedBackground
必要性: 選用
接受:主題色彩。
索引標籤
這些是控制終端機中個別索引標籤外觀的設定。
屬性名稱:tab
背景色彩
使用中索引標籤的色彩。在設定檔中設定 tabColor
會覆寫此值。 同樣地,使用索引標籤色彩選擇器設定執行階段色彩也會覆寫色彩。
此色彩一律會被視為純色,即使設定為具有壓克力背景的 terminalBackground
窗格亦同。
屬性名稱:background
必要性: 選用
接受:主題色彩。
非使用中背景色彩
非使用中索引標籤的色彩。 在設定檔中設定 tabColor
會覆寫此值。 同樣地,使用索引標籤色彩選擇器設定執行階段色彩也會覆寫色彩。
此色彩一律會被視為純色,即使設定為具有壓克力背景的 terminalBackground
窗格亦同。
當設定為 terminalBackground
或 accent
時,這會自動使用 30% 的 Alpha 值,以變成半透明。
屬性名稱:unfocusedBackground
必要性: 選用
接受:主題色彩。
顯示關閉按鈕
設定索引標籤上的 [關閉] 按鈕顯示方式。 接受下列的值:
"always"
:一律顯示索引標籤關閉按鈕。"hover"
:在使用中的索引標籤顯示索引標籤關閉按鈕,其他索引標籤則在滑鼠停留時才顯示。"never"
:永不顯示索引標籤關閉按鈕。 這也會停用透過滑鼠中間按鈕關閉索引標籤的功能。"activeOnly"
:僅在使用中的索引標籤顯示索引標籤關閉按鈕。
屬性名稱:showCloseButton
必要性: 選用
接受:"always"
、"hover"
、"never"
、"activeOnly"
預設值:"always"
佈景主題色彩
在主題中使用的色彩都接受 RGBA 色彩值,以及一些自訂值的特殊字串。 接受的值如下:
"#rgb
、"#rrggbb
、"#rrggbbaa
:RGB 色彩值。 若省略 Alpha 色板,這些色彩預設為完全不透明的 Alpha 色板。"accent"
:此為特殊值,表示「系統設定中設定的輔色集」。"terminalBackground"
:此為特殊值,經評估以表示「使用中終端機窗格的背景色彩」。 如果索引標籤中有多個窗格,則這是使用中窗格的色彩。 這一律會使用設定檔的background
,並忽略backgroundImage
的任何內容 (如有設定)。