Share via

Paramètres de thème du Terminal Windows (préversion)

  • Article

Les paramètres indiqués ci-dessous affectent les visuels de la fenêtre de terminal proprement dite, et non l’apparence d’un onglet ni d’un volet individuel. Ces paramètres ne sont actuellement modifiables directement que dans le fichier settings.json. Ils ne sont pas configurables dans l’interface utilisateur des paramètres.

"theme": "dark"
"themes":
[
    // THEME OBJECTS
]

Pour voir des exemples de thèmes, consultez la galerie de thèmes.

Chacun des thèmes de la liste themes est constitué d’une collection d’objets de propriété, qui spécifient les propriétés des éléments individuels de l’application. Par exemple, le thème "dark" par défaut est le suivant :

{
    "name": "dark",
    "window": {
        "applicationTheme": "dark"
    },
    "tab": {
        "background": "terminalBackground",
        "unfocusedBackground": "#00000000"
    },
    "tabRow": {
        "unfocusedBackground": "#333333FF"
    }
},

Vous pouvez également configurer le terminal pour utiliser des thèmes distincts pour les modes Clair et Sombre dans le système d’exploitation et passer automatiquement d’un thème à l’autre quand le thème du système d’exploitation change. Pour cela, spécifiez la propriété theme en tant qu’objet contenant les clés light et dark :

"theme": { "dark": "<Dark Theme Name>", "light": "<Light Theme Name>" },

Nom du thème

Ce paramètre correspond au nom du thème. Chaque nom doit être unique. Les noms dark, light et system sont réservés aux thèmes par défaut intégrés.

Nom de la propriété :name

Nécessité : Obligatoire

Valeurs possibles : le nom du thème sous forme de chaîne


Fenêtre

Ces paramètres sont utilisés pour configurer l’apparence de l’ensemble de la fenêtre du terminal.

Nom de la propriété :window

Thème d’application

Définir le thème de l’interface utilisateur de l’application. Il permet de fixer le style des éléments d’interface utilisateur de l’application, notamment les boutons et la palette de commandes. Ce style peut être clair ou foncé. "system" utilise le même thème que Windows.

Nom de la propriété :applicationTheme

Nécessité : Facultatif

Accepte :"system", "dark", "light"

Valeur par défaut :"dark"

Mica

Cela active l’effet Mica sur cette fenêtre, sous toutes les autres couches de l’interface utilisateur. Pour que Mica soit visible, les couches situées au-dessus doivent être transparentes. Par exemple, pour avoir une rangée d’onglets avec Mica, vous devez configurer le canal alpha de l’arrière-plan sur 0, comme ceci :

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

Notez que lorsque Mica est activé pour la fenêtre, il est activé dans l’intégralité de la fenêtre, y compris comme toile de fond pour les volets du terminal dans la fenêtre. Cela signifie que les profils qui utilisent opacity sans useAcrylic activé feront apparaître le nouvel arrière-plan Mica. Il n’est actuellement pas possible d’avoir simultanément un arrière-plan transparent non flou pour le terminal et un arrière-plan Mica pour la rangée d’onglets.

Nom de la propriété :useMica

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false

Remarque

Mica n’est disponible que sur les builds Windows >= 22621.

Bordure de fenêtre

Cette option permet de définir la couleur de la bordure de fenêtre lorsque celle-ci est active. Lorsqu’elle est définie sur null, la bordure utilise la couleur par défaut pour le thème du système d’exploitation.

Nom de la propriété :frame

Nécessité : Facultatif

Valeur possible : une couleur de thème

Valeur par défaut :null

Remarque

Les couleurs de bordure de fenêtre sont uniquement disponibles sur Windows 11.

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.

Bordure de fenêtre inactive

Cette option permet de définir la couleur de la bordure de fenêtre lorsque celle-ci est inactive. Lorsqu’elle est définie sur null, la bordure utilise la couleur par défaut pour le thème du système d’exploitation.

Nom de la propriété :unfocusedFrame

Nécessité : Facultatif

Valeur possible : une couleur de thème

Valeur par défaut :null

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.

Version expérimentale : bordure de fenêtre arc-en-ciel

Lorsqu’il est activé, ce paramètre entraîne le cycle de la bordure de fenêtre via les couleurs de l’arc-en-ciel. Il s'agit d'une fonctionnalité expérimentale et sa pérennité n'est pas garantie. Lorsque ce paramètre est activé, il est prioritaire sur frame et unfocusedFrame.

The Windows Terminal with rainbowFrame enabled

Nom de la propriété :experimental.rainbowFrame

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.


Ligne d’onglets

Configurer l’apparence de la ligne d’onglets. Quand showTabsInTitlebar prend la valeur true (par défaut), ils configurent la barre de titre.

Nom de la propriété :tabRow

Couleur d'arrière-plan

Couleur de la ligne d’onglets lorsque la fenêtre se trouve au premier plan.

Nom de la propriété :background

Nécessité : Facultatif

Valeurs possibles : une couleur de thème.

Couleur de l’arrière-plan inactif

Couleur de la ligne d’onglets lorsque la fenêtre est inactive.

Nom de la propriété :unfocusedBackground

Nécessité : Facultatif

Valeurs possibles : une couleur de thème.


Tabulations

Il s’agit des paramètres qui contrôlent l’apparence des onglets individuels dans le terminal.

Nom de la propriété :tab

Couleur d'arrière-plan

Couleur de l’onglet actif. Cette valeur est remplacée si une valeur tabColor est définie dans un profil. La couleur est également écrasée lorsqu’une couleur est paramétrée à l’exécution avec le sélecteur de couleurs d’onglet.

Cette couleur est toujours traitée comme une couleur unie, même si elle est définie sur le terminalBackground d’un volet avec arrière-plan acrylique.

Nom de la propriété :background

Nécessité : Facultatif

Valeurs possibles : une couleur de thème.

Couleur de l’arrière-plan inactif

Couleur des onglets inactifs. Cette valeur est remplacée si une valeur tabColor est définie dans un profil. La couleur est également écrasée lorsqu’une couleur est paramétrée à l’exécution avec le sélecteur de couleurs d’onglet.

Cette couleur est toujours traitée comme une couleur unie, même si elle est définie sur le terminalBackground d’un volet avec arrière-plan acrylique.

Lorsque cette valeur est définie sur terminalBackground ou accent, elle utilise automatiquement une valeur alpha de 30 % pour être semi-transparente.

Nom de la propriété :unfocusedBackground

Nécessité : Facultatif

Valeurs possibles : une couleur de thème.

Affichage du bouton Fermer

Configure la façon dont le bouton « Fermer » de l’onglet apparaît. Ce paramètre accepte les valeurs suivantes :

  • "always" : toujours afficher le bouton Fermer des onglets.
  • "hover" : afficher le bouton Fermer sur l’onglet actif et tous les onglets sur lesquels passe la souris.
  • "never" : ne jamais afficher le bouton Fermer des onglets. Cette valeur a également pour effet de désactiver la possibilité de fermer l’onglet avec le bouton central de la souris.
  • "activeOnly" : afficher le bouton Fermer sur l’onglet actif uniquement.

Nom de la propriété :showCloseButton

Nécessité : Facultatif

Accepte :"always", "hover", "never", "activeOnly"

Valeur par défaut :"always"


Couleurs du thème

Les couleurs utilisées dans les thèmes acceptent les valeurs RVBA, ainsi que quelques chaînes spéciales pour les valeurs personnalisées. Les valeurs acceptées sont les suivantes :

  • "#rgb, "#rrggbb et "#rrggbbaa : une valeur de couleur RVB. Lorsque le canal alpha est omis, ces couleurs correspondent par défaut à un canal alpha entièrement opaque.
  • "accent" : une valeur spéciale signifiant « la couleur d’accentuation définie dans les paramètres système ».
  • "terminalBackground" : une valeur spéciale évaluée comme signifiant « la couleur d’arrière-plan du volet de terminal actif ». S’il existe plusieurs volets dans un onglet, il s’agit de la couleur du volet actif. Cette valeur utilise toujours le profil background et ignore tout ce qui provient d’une backgroundImage (le cas échéant).