Paramètres du profil d’apparence dans le Terminal Windows

Les paramètres listés ci-dessous affectent les paramètres visuels de chaque profil séparément. Si vous souhaitez qu’un paramètre s’applique à tous vos profils, vous pouvez l’ajouter à la section defaults au-dessus de la liste des profils dans votre fichier settings.json.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Texte

Modèle de couleurs

Il s’agit du nom du modèle de couleurs utilisé dans le profil. Les modèles de couleurs sont définis dans l’objet schemes. Vous trouverez des informations plus détaillées sur la page Modèles de couleurs.

En plus d’un nom de modèle de couleurs unique, cette propriété accepte une paire de noms de modèles de couleurs, comme ceci :

"colorScheme":
{
    "light": "One Half Light",
    "dark": "One Half Dark",
},

Si vous spécifiez la propriété de cette manière, le terminal bascule automatiquement entre les deux modèles de couleurs donnés en fonction du thème de l’application. Le terminal suit la propriété theme.applicationTheme du thème sélectionné du terminal. Si applicationTheme est défini sur system, le modèle de couleurs correspondant au thème du système d’exploitation est utilisé à la place.

Nom de la propriété : colorScheme

Nécessité : Facultatif

Accepte : le nom du modèle de couleurs sous la forme d’une chaîne ou d’un objet avec une propriété light ou dark

Valeur par défaut : "Campbell"

Police

Il s’agit de la structure dans laquelle les autres paramètres de police doivent être définis. Vous pouvoir voir à quoi cela peut ressembler dans le fichier JSON ci-dessous.

Nom de la propriété : font

Nécessité : Facultatif

Font face

Il s’agit du nom du type de police utilisé dans le profil. Le terminal essaiera de revenir à Consolas s’il est introuvable ou non valide. Pour en savoir plus sur les autres variantes de la police par défaut, Cascadia Mono, accédez à la page Cascadia Code.

Nom de la propriété : face (défini dans l’objet font )

Nécessité : Facultatif

Accepte : Nom de police sous forme de chaîne

Valeur par défaut : "Cascadia Mono"

Taille de police

Définit la taille de police du profil en points.

Nom de la propriété : size (défini dans l’objet font )

Nécessité : Facultatif

Accepte : Entier

Valeur par défaut : 12

Épaisseur de police

Cela définit l’épaisseur (légèreté ou lourdeur des traits) de la police du profil.

Nom de la propriété : weight (défini dans l’objet font )

Nécessité : Facultatif

Accepte : "normal", "thin", "extra-light", "light", "semi-light", "medium", "semi-bold", "bold", "extra-bold", "black", "extra-black" ou un entier correspondant à la représentation numérique de l’épaisseur de police OpenType

Valeur par défaut : "normal"

Exemple de police

"font": {
    "face": "Cascadia Mono",
    "size": 12,
    "weight": "normal"
}

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

Caractéristiques de police

Définit les caractéristiques de police OpenType pour la police donnée.

Nom de la propriété : features (défini dans l’objet font )

Nécessité : Facultatif

Accepte : Propriétés de la caractéristique au format "string": integer

Exemple :

// Enables ss01 and disables ligatures
"font": {
    "face": "Cascadia Code",
    "features": {
        "ss01": 1,
        "liga": 0
    }
}

Axes de police

Définit les axes de police OpenType pour la police donnée.

Nom de la propriété : axes (défini dans l’objet font )

Nécessité : Facultatif

Accepte : Propriétés de l’axe au format "string": integer

Exemple :

// Sets the font to italic
"font": {
    "face": "Cascadia Code",
    "axes": {
        "ital": 1
    }
}

Mise en forme du texte intense

Cette commande contrôle la mise en forme du texte « intense » dans le terminal. Le texte « intense » est mis en forme avec la séquence d’échappement \x1b[1m.

Nom de la propriété : intenseTextStyle

Nécessité : Facultatif

Accepte : "none", "bold", "bright", "all"

• "all" : affiche le texte intense en gras et avec une couleur brillante
• "bold" : affiche le texte intense en gras, mais pas avec une couleur brillante
• "bright" : affiche le texte intense avec une couleur brillante, mais pas en gras
• "none" : le terminal ne fait rien de spécial pour le texte intense

Valeur par défaut : "bright"

Effets façon rétro pour le terminal

Curseur

Forme de curseur

Définit la forme du curseur pour le profil. Les curseurs possibles sont les suivants : "bar" ( ┃ ), "vintage" ( ▃ ), "underscore" ( ▁ ), "filledBox" ( █ ), "emptyBox" ( ▯ ), "doubleUnderscore" ( ‗ )

Nom de la propriété : cursorShape

Nécessité : Facultatif

Accepte : "bar", , "underscore""vintage", "filledBox", "emptyBox","doubleUnderscore"

Valeur par défaut : "bar"

Hauteur du curseur

Définit la hauteur en pourcentage du curseur en partant du bas. Cela ne fonctionne que si cursorShape est défini sur "vintage".

Nom de la propriété : cursorHeight

Nécessité : Facultatif

Accepte : Entier compris entre 1 et 100

Images d’arrière-plan et icônes

Le Terminal Windows vous permet de spécifier des images d’arrière-plan et des icônes personnalisées à l’aide de l’interface utilisateur des paramètres ou du fichier settings.json pour chacun de vos profils de ligne de commande. Vous pouvez ainsi configurer, personnaliser et styliser chacun de vos profils de manière indépendante. Pour cela, spécifiez votre backgroundImage préférée, positionnez-la avec backgroundImageAlignment, définissez son opacité avec backgroundImageOpacity et/ou spécifiez comment votre image remplira l’espace disponible avec backgroundImageStretchMode.

Par exemple :

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

Vous pouvez facilement appliquer votre collection d’images et d’icônes à l’ensemble de vos machines en stockant vos icônes et images dans OneDrive (comme indiqué ci-dessus).

Chemin de l’image d’arrière-plan

Définit l’emplacement de fichier de l’image à dessiner sur l’arrière-plan de la fenêtre. L’image d’arrière-plan peut être un fichier. jpg,. png ou. gif. "desktopWallpaper" définit définir le papier peint du Bureau comme image d’arrière-plan.

Nom de la propriété : backgroundImage

Nécessité : Facultatif

Accepte : Emplacement du fichier en tant que chaîne ou "desktopWallpaper"

Nous vous recommandons de stocker les images et icônes personnalisées dans des dossiers fournis par le système et de les référencer en utilisant les schémas d’URI appropriés. Les schémas d’URI permettent de référencer des fichiers indépendamment de leurs chemins physiques (qui peuvent être amenés à changer). Les schémas d’URI les plus utiles lors de la personnalisation d’images d’arrière-plan et d’icônes sont les suivants :

Icônes

Le Terminal Windows affiche des icônes pour chaque profil généré par le terminal pour les shells intégrés, par exemple PowerShell Core, PowerShell et toute distribution Linux/WSL installée. Chaque profil fait référence à une icône d’une banque d’icônes par le biais du schéma d’URI ms-appx. Vous pouvez faire référence à vos propres icônes personnalisées en entrant un chemin dans votre fichier settings.json :

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

Les icônes doivent mesurer 32 x 32 px et être enregistrées dans un format d’image raster approprié (.PNG, .GIF, .ICO, etc.) pour éviter toute mise à l’échelle pendant l’exécution (provoquant un retard notable et une perte de qualité).

Si aucune icône n’est spécifiée pour une ligne de commande que vous avez installée, le Terminal Windows utilise par défaut ce glyphe à partir de la police Segoe Fluent :

Glyphe	Point de code Unicode	Description
	e756	CommandPrompt

Mode d’étirement de l’image d’arrière-plan

Alignement de l’image d’arrière-plan

Opacité de l’image d’arrière-plan

Nom de la propriété : backgroundImageOpacity

Nécessité : Facultatif

Accepte : Nombre sous forme de valeur à virgule flottante comprise entre 0 et 1

Valeur par défaut : 1.0

Transparence

Opacity

Activer l’acrylique

Fenêtre

Espacement

Visibilité de la barre de défilement

Définit la visibilité de la barre de défilement.

Nom de la propriété : scrollbarState

Nécessité : Facultatif

Accepte : "visible", , "hidden"(à compter de la version 1.17, "always" sera inclus)

Paramètres de couleur

Couleur de l’onglet

Définit la couleur de l’onglet du profil. Elle est remplacée par une autre couleur si vous utilisez le sélecteur de couleurs d’onglet.

Nom de la propriété : tabColor

Nécessité : Facultatif

Accepte : Couleur sous forme de chaîne au format hexadécimal : "#rgb" ou "#rrggbb"

Couleur de premier plan

Modifie la couleur de premier plan du profil. Elle remplace la valeur foreground définie dans le modèle de couleurs si colorScheme est défini.

Nom de la propriété : foreground

Nécessité : Facultatif

Accepte : Couleur sous forme de chaîne au format hexadécimal : "#rgb" ou "#rrggbb"

Couleur d’arrière-plan

Modifie la couleur d’arrière-plan du profil avec ce paramètre. Elle remplace la valeur background définie dans le modèle de couleurs si colorScheme est défini.

Nom de la propriété : background

Nécessité : Facultatif

Accepte : Couleur sous forme de chaîne au format hexadécimal : "#rgb" ou "#rrggbb"

Couleur d’arrière-plan de sélection

Définit la couleur d’arrière-plan d’une sélection dans le profil. Elle remplace la valeur selectionBackground définie dans le modèle de couleurs si colorScheme est défini.

Nom de la propriété : selectionBackground

Nécessité : Facultatif

Accepte : Couleur sous forme de chaîne au format hexadécimal : "#rgb" ou "#rrggbb"

Ajuster les couleurs impossibles à distinguer

Ce paramètre ajuste la couleur du premier plan pour le rendre plus visible en fonction de la couleur d’arrière-plan. Quand il est défini sur always, les couleurs sont toujours ajustées. Quand il est défini sur indexed, les couleurs sont ajustées uniquement si elles font partie du jeu de couleurs. Quand il est défini sur never, les couleurs ne sont jamais ajustées.

Nom de la propriété : adjustIndistinguishableColors

Nécessité : Facultatif

Accepte : always, indexed, never

Couleur du curseur

Cette propriété définit la couleur du curseur du profil. Elle remplace la valeur cursorColor définie dans le modèle de couleurs si colorScheme est défini.

Nom de la propriété : cursorColor

Nécessité : Facultatif

Accepte : Couleur sous forme de chaîne au format hexadécimal : "#rgb" ou "#rrggbb"

Paramètres d’apparence inactifs

Objet que vous pouvez ajouter à un profil qui applique des paramètres au profil quand il n’a pas le focus. Ce paramètre accepte uniquement des paramètres d’apparence.

Nom de la propriété : unfocusedAppearance

Nécessité : Facultatif

Accepte : , , backgroundImageOpacitybackgroundImageAlignment, backgroundImageStretchMode, cursorHeightcursorColoruseAcryliccursorShapeforegroundexperimental.retroTerminalEffectcolorSchemebackgroundopacityselectionBackgroundbackgroundImageexperimental.pixelShaderPath

Exemple :

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance":
{
    "backgroundImageOpacity": 0.3
},

Effets du nuanceur de pixels

Ce paramètre permet à un utilisateur de spécifier le chemin à un nuanceur de pixels personnalisé à utiliser avec le contenu du terminal. Il s’agit d’une fonctionnalité expérimentale dont l’existence à long terme n’est pas garantie. Pour plus d’informations sur la création de nuanceurs de pixels personnalisés pour le terminal, consultez cette documentation.

Si ce paramètre est défini, il remplace experimental.retroTerminalEffect.

Nom de la propriété : experimental.pixelShaderPath

Nécessité : Facultatif

Accepte : Chemin à un fichier de nuanceur .hlsl, en tant que chaîne