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 テーマが変更されたときにそれらのテーマ間で自動的に変更されるようにできます。 これを行うには、キー light と dark を含むオブジェクトとして theme プロパティを指定します。

"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 レイヤーの下で、このウィンドウに対するマイカ効果が有効になります。 マイカを表示するには、その上のレイヤーを透明にする必要があります。 たとえば、マイカを含むタブ行を使用するには、背景のアルファ チャネルをが 0 になるように、次のように構成する必要があります。

{
    "name": "My Mica Theme",
    "tab":
    {
        "background": "terminalBackground"
    },
    "tabRow":
    {
        "background": "#00000000"
    },
    "window":
    {
        "applicationTheme": "system",
        "useMica": true
    }
},

マイカがウィンドウに対して有効になっている場合、ウィンドウのターミナル ペインの背景としてを含め、ウィンドウ全体の下で有効になります。 これは、useAcrylic を有効にせずに opacity を使用しているプロファイルが新しいマイカの背景に表示されることを意味します。 現在、ターミナルの透明な背景とタブ/タブ行のマイカの背景を同時に持つことはできません。

プロパティ名:useMica

必須かどうか: オプション

受け入れ可能:true、false

既定値:false

Note

マイカは、Windows ビルド 22621 以上でのみ使用できます。

ウィンドウの境界線

ウィンドウがアクティブな場合に、ウィンドウの境界線の色を設定します。 null に設定すると、境界線は OS テーマの既定の色が使用されます。

プロパティ名:frame

必須かどうか: オプション

受け入れ可能:テーマの色

既定値:null

Note

ウィンドウの境界線の色は、Windows 11 でのみ使用可能です。

重要

この機能は、Windows ターミナル プレビューでのみ使用できます。

非アクティブなウィンドウの境界線

ウィンドウが非アクティブな場合に、ウィンドウの境界線の色を設定します。 null に設定すると、境界線は OS テーマの既定の色が使用されます。

プロパティ名:unfocusedFrame

必須かどうか: オプション

受け入れ可能:テーマの色

既定値:null

重要

この機能は、Windows ターミナル プレビューでのみ使用できます。

実験: 虹色のウィンドウの境界線

この設定を有効にすると、ウィンドウの境界線が虹色で循環します。 これは試験的な機能であり、存続は保証されていません。 この設定を有効にすると、frame と unfocusedFrame の両方よりも優先されます。

The Windows Terminal with rainbowFrame enabled

プロパティ名:experimental.rainbowFrame

必須かどうか: オプション

受け入れ可能:true、false

既定値:false

重要

この機能は、Windows ターミナル プレビューでのみ使用できます。


タブ行

これらの設定は、タブ行の外観を構成するために使われます。 showTabsInTitlebar が true の場合 (既定値)、タイトル バーが構成されます。

プロパティ名:tabRow

背景の色

ウィンドウが前景にあるときのタブ行の色。

プロパティ名:background

必須かどうか: オプション

受け入れ可能:テーマの色。

非アクティブな背景色

ウィンドウが非アクティブな場合のタブ行の色。

プロパティ名:unfocusedBackground

必須かどうか: オプション

受け入れ可能:テーマの色。


タブ

ターミナル内の個々のタブの外観を制御する設定です。

プロパティ名:tab

背景の色

アクティブなタブの色。プロファイルで tabColor を設定すると、この値がオーバーライドされます。 同様に、実行時にタブ カラー ピッカーを使って色を設定すると、この色はオーバーライドされます。

アクリルの背景を使ってペインの terminalBackground に設定した場合でも、この色は常に単色として扱われます。

プロパティ名:background

必須かどうか: オプション

受け入れ可能:テーマの色。

非アクティブな背景色

非アクティブなタブの色。 プロファイルで tabColor を設定すると、この値はオーバーライドされます。 同様に、実行時にタブ カラー ピッカーを使って色を設定すると、この色はオーバーライドされます。

アクリルの背景を使ってペインの terminalBackground に設定した場合でも、この色は常に単色として扱われます。

terminalBackground または accent に設定すると、アルファ値 30% が自動的に使われ、半透明になります。

プロパティ名:unfocusedBackground

必須かどうか: オプション

受け入れ可能:テーマの色。

[閉じる] ボタンを表示する

タブの [閉じる] ボタンの表示方法を構成します。 次の値を受け入れることができます。

  • "always": 常にタブの [閉じる] ボタンを表示します。
  • "hover": アクティブなタブとマウス ポインターを置いたタブにタブの [閉じる] ボタンを表示します。
  • "never": タブの [閉じる] ボタンを表示しません。 この場合、中央のマウス ボタンを使ってタブを閉じる機能も無効になります。
  • "activeOnly": アクティブなタブのみにタブの [閉じる] ボタンを表示します。

プロパティ名:showCloseButton

必須かどうか: オプション

受け入れ可能:"always"、"hover"、"never"、"activeOnly"

既定値:"always"


テーマの色

テーマに使われる色は、RGBA カラー値と、カスタム値用のいくつかの特殊な文字列を受け入れます。 許容される値は次のとおりです。

  • "#rgb、"#rrggbb、"#rrggbbaa: RGB カラー値。 アルファ チャネルを省略した場合、これらの色の既定値は完全に不透明なアルファ チャネルになります。
  • "accent": これは、"システム設定で設定されたアクセント カラー" を意味する特殊な値です。
  • "terminalBackground": これは、"アクティブなターミナル ペインの背景色" を意味するように評価される特殊な値です。 1 つのタブに複数のペインがある場合、この色はアクティブなものの色になります。 プロファイルの background が常に使われます。backgroundImage の項目は、設定した場合でも無視されます。