Share via

Impostazioni del tema in Terminale Windows (Anteprima)

  • Articolo

Le impostazioni elencate di seguito influiscono sull'aspetto della finestra del terminale stessa, piuttosto che sull'aspetto di una singola scheda/riquadro. Queste impostazioni possono essere modificate solo nel file settings.json e non possono essere configurate tramite l'interfaccia utente delle impostazioni.

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

Per alcuni temi di esempio, esaminare la raccolta Temi.

Ogni tema nell'elenco themes è costituito da una raccolta di oggetti proprietà, che specificano le proprietà dei singoli elementi dell'applicazione. Ad esempio, il tema predefinito "dark" è il seguente:

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

È possibile impostare il Terminale affinché adotti temi diversi per le modalità chiara e scura del sistema operativo, cambiando automaticamente a seconda del tema attivo sul sistema operativo. A tale scopo, specificare la proprietà theme come oggetto che contiene le chiavi light e dark:

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

Nome tema

Questo è il nome del tema. I nomi devono essere univoci. I nomi dark, lighte system sono riservati ai temi predefiniti.

Nome proprietà:name

Necessità: obbligatoria

Accetta: nome del tema come stringa


Window

Queste impostazioni servono per configurare l'aspetto dell'intera finestra del Terminale.

Nome proprietà:window

Tema applicazione

In questo modo viene impostato il tema dell'interfaccia utente dell'applicazione. In questo modo si stilizzano elementi come i pulsanti, il pannello dei comandi e altri elementi dell'interfaccia utente dell'applicazione. Può essere chiaro o scuro. Con "system" viene usato lo stesso tema di Windows.

Nome proprietà:applicationTheme

Necessità: facoltativa

Accetta:"system", "dark", "light"

Valore predefinito:"dark"

Mica

In questo modo si abilita l'effetto Mica in questa finestra, sotto tutti gli altri livelli dell'interfaccia utente. Affinché Mica sia visibile, i livelli superiori devono essere trasparenti. Ad esempio, per avere una riga di tabulazione con Mica, è necessario configurare il canale alfa dello sfondo su 0 come indicato di seguito:

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

Quando Mica è attivato per la finestra, funziona sull'intera superficie, fungendo anche da sfondo per i riquadri del Terminale presenti nella finestra. Ciò significa che i profili che usano opacity senza useAcrylic abilitato verranno visualizzati attraverso il nuovo sfondo Mica. Attualmente non è possibile avere uno sfondo trasparente non crittografato per il Terminale e uno sfondo Mica per le schede/riga di tabulazioni contemporaneamente.

Nome proprietà:useMica

Necessità: facoltativa

Accetta:true, false

Valore predefinito:false

Nota

Mica è disponibile solo nelle build di Windows >= 22621.

Bordo finestra

In questo modo viene impostato il colore del bordo della finestra, quando questa è attiva. Se impostato su null, il bordo userà il colore predefinito per il tema del sistema operativo.

Nome proprietà:frame

Necessità: facoltativa

Accetta: un colore del tema

Valore predefinito:null

Nota

I colori dei bordi delle finestre sono disponibili solo in Windows 11.

Importante

Questa funzionalità è disponibile solo in Terminale Windows (anteprima).

Bordo finestra inattiva

In questo modo viene impostato il colore del bordo della finestra, quando la finestra è inattiva. Se impostato su null, il bordo userà il colore predefinito per il tema del sistema operativo.

Nome proprietà:unfocusedFrame

Necessità: facoltativa

Accetta: un colore del tema

Valore predefinito:null

Importante

Questa funzionalità è disponibile solo in Terminale Windows (anteprima).

Sperimentale: bordo finestra arcobaleno

Se attivata, questa impostazione fa sì che il bordo della finestra assuma i colori dell'arcobaleno. Questa è una funzionalità in fase sperimentale e la sua permanenza non è assicurata. Quando questa impostazione è abilitata, avrà la precedenza sia su frame che su unfocusedFrame.

The Windows Terminal with rainbowFrame enabled

Nome proprietà:experimental.rainbowFrame

Necessità: facoltativa

Accetta:true, false

Valore predefinito:false

Importante

Questa funzionalità è disponibile solo in Terminale Windows (anteprima).


Riga di tabulazione

Queste impostazioni vengono utilizzate per configurare l'aspetto della riga di tabulazione. Quando showTabsInTitlebar è true (impostazione predefinita), viene configurata la barra del titolo.

Nome proprietà:tabRow

Colore sfondo

Il colore della riga di tabulazione quando la finestra è in primo piano.

Nome proprietà:background

Necessità: facoltativa

Accetta: un colore del tema.

Colore di sfondo inattivo

Il colore della riga di tabulazione quando la finestra è inattiva.

Nome proprietà:unfocusedBackground

Necessità: facoltativa

Accetta: un colore del tema.


Schede

Si tratta di impostazioni che controllano l'aspetto delle singole schede del Terminale.

Nome proprietà:tab

Colore sfondo

Il colore della scheda attiva. L'impostazione di tabColor in un profilo sostituirà questo valore. Analogamente, l'impostazione di un colore in fase di esecuzione con il selettore di colori delle schede sostituirà questo colore.

Questo colore viene sempre considerato come un colore a tinta unita, anche se impostato su terminalBackground di un riquadro con sfondo acrilico.

Nome proprietà:background

Necessità: facoltativa

Accetta: un colore del tema.

Colore di sfondo inattivo

Il colore delle schede inattive. L'impostazione di tabColor in un profilo sostituirà questo valore. Analogamente, l'impostazione di un colore in fase di esecuzione con il selettore di colori delle schede sostituirà questo colore.

Questo colore viene sempre considerato come un colore a tinta unita, anche se impostato su terminalBackground di un riquadro con sfondo acrilico.

Se impostato su terminalBackground o accent, verrà usato automaticamente un valore alfa pari al 30%, per essere semitrasparente.

Nome proprietà:unfocusedBackground

Necessità: facoltativa

Accetta: un colore del tema.

Mostra pulsante di chiusura

Configura la modalità di visualizzazione del pulsante "Chiudi" nella scheda. Accetta i seguenti valori:

  • "always": mostra sempre i pulsanti di chiusura della scheda.
  • "hover": mostra il pulsante di chiusura della scheda nella scheda attiva e tutte le schede che vengono spostate con il mouse.
  • "never": non mostra mai i pulsanti di chiusura della scheda. In questo modo viene disabilitata anche la possibilità di chiudere la scheda con il pulsante centrale del mouse.
  • "activeOnly": mostra il pulsante di chiusura della scheda solo nella scheda attiva.

Nome proprietà:showCloseButton

Necessità: facoltativa

Accetta:"always", "hover", "never", "activeOnly"

Valore predefinito:"always"


Colori del tema

I colori usati nei temi accettano entrambi i valori di colore RGBA, nonché alcune stringhe speciali per valori personalizzati. I valori accettati sono i seguenti:

  • "#rgb, "#rrggbb, "#rrggbbaa: un valore di colore RGB. Quando il canale alfa viene omesso, questi colori sono impostati su un canale alfa completamente opaco.
  • "accent": si tratta di un valore speciale che indica "il colore principale impostato nelle impostazioni di sistema".
  • "terminalBackground": si tratta di un valore speciale valutato per indicare "il colore di sfondo del riquadro del terminale attivo". Se in una scheda sono presenti più riquadri, questo è il colore di quello attivo. In questo modo viene sempre usato l'oggetto background del profilo, che ignora qualsiasi elemento da backgroundImage, se impostato.