Configurações de tema do Terminal do Windows (versão prévia)

  • Artigo

As configurações listadas abaixo afetam os visuais da própria janela do terminal, em vez da aparência de uma guia/painel individual. No momento, essas configurações só podem ser editadas diretamente no arquivo settings.json e não são configuráveis por meio da interface do usuário de configurações.

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

Para alguns temas de exemplo, dê uma olhada na galeria de temas.

Cada tema na lista themes é composto por uma coleção de objetos de propriedade, que especificam as propriedades de elementos individuais do aplicativo. Por exemplo, o tema padrão "dark" é o seguinte:

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

Você também pode configurar o Terminal para usar temas separados nos modos claro e escuro do sistema operacional e alternar automaticamente entre eles sempre que o tema do sistema operacional for alterado. Para fazer isso, especifique a propriedade theme como um objeto que contém as chaves light e dark:

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

Nome do tema

Esse é o nome do tema. Os nomes devem ser exclusivos. Os nomes dark, light e system são reservados para os temas padrão internos.

Nome da propriedade:name

Necessidade: Necessária

Aceita: nome do tema como uma cadeia de caracteres


Janela

Essas configurações são usadas para definir a aparência da janela inteira do Terminal.

Nome da propriedade:window

Tema de aplicativo

Isso define o tema da UI do aplicativo. Isso estilizará itens como botões, a paleta de comandos e outros elementos da interface do usuário do aplicativo. Pode ser claro ou escuro. O "system" usará o mesmo tema que o Windows.

Nome da propriedade:applicationTheme

Necessidade: Opcional

Aceita:"system", "dark", "light"

Valor padrão:"dark"

Mica

Isso habilita o efeito Mica nessa janela, abaixo de todas as outras camadas da interface do usuário. Para que a Mica fique visível, as camadas acima dela precisam ser transparentes. Por exemplo, para ter uma linha de tabulação com Mica, você precisará configurar o canal alfa da tela de fundo para ser 0 da seguinte maneira:

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

Observe que quando o Mica está habilitado para a janela, ele é habilitado em toda a janela, inclusive como tela de fundo para os painéis do Terminal na janela. Isso significa que os perfis que estão usando opacity sem o useAcrylic habilitado serão exibidos através da nova tela de fundo Mica. No momento, não é possível ter uma tela de fundo transparente sem desfoque para o Terminal e uma tela de fundo Mica para a guias/linhas de guia simultaneamente.

Nome da propriedade:useMica

Necessidade: Opcional

Aceita:true, false

Valor padrão:false

Observação

O Mica só está disponível em builds do Windows >= 22621.

Borda da janela

Isso define a cor da borda da janela quando a janela estiver ativa. Quando definido como null, a borda usará qualquer cor padrão definida como tema do sistema operacional.

Nome da propriedade:frame

Necessidade: Opcional

Aceita: uma cor de tema

Valor padrão:null

Observação

As cores da borda da janela só estão disponíveis no Windows 11.

Importante

Este recurso só está disponível na Visualização do Terminal do Windows.

Borda de janela inativa

Isso define a cor da borda da janela quando a janela estiver inativa. Quando definido como null, a borda usará qualquer cor padrão definida como tema do sistema operacional.

Nome da propriedade:unfocusedFrame

Necessidade: Opcional

Aceita: uma cor de tema

Valor padrão:null

Importante

Este recurso só está disponível na Visualização do Terminal do Windows.

Experimental: Borda da janela em arco-íris

Quando habilitada, essa configuração fará com que a borda da janela percorra as cores do arco-íris. Esse é um recurso experimental e sua existência contínua não é garantida. Quando essa configuração estiver habilitada, ela terá precedência sobre ambos frame e unfocusedFrame.

The Windows Terminal with rainbowFrame enabled

Nome da propriedade:experimental.rainbowFrame

Necessidade: Opcional

Aceita:true, false

Valor padrão:false

Importante

Este recurso só está disponível na Visualização do Terminal do Windows.


Linha da guia

Essas configurações são usadas para configurar a aparência da linha da guia. Quando showTabsInTitlebar é true (o padrão), configura a barra de título.

Nome da propriedade:tabRow

Cor da tela de fundo

A cor da linha da guia quando a janela está em primeiro plano.

Nome da propriedade:background

Necessidade: Opcional

Aceita: uma cor de tema.

Cor da tela de fundo inativa

A cor da linha da guia quando a janela está inativa.

Nome da propriedade:unfocusedBackground

Necessidade: Opcional

Aceita: uma cor de tema.


Tabulações

Essas são configurações que controlam a aparência de guias individuais no Terminal.

Nome da propriedade:tab

Cor da tela de fundo

A cor da guia ativa. Definir um tabColor em um perfil substituirá esse valor. Da mesma forma, definir uma cor em runtime com o seletor de cores de guia substituirá essa cor.

Essa cor sempre é tratada como uma cor sólida, mesmo que definida como um terminalBackground de um painel com uma tela de fundo acrílico.

Nome da propriedade:background

Necessidade: Opcional

Aceita: uma cor de tema.

Cor da tela de fundo inativa

A cor das guias inativas. Definir um tabColor em um perfil substituirá esse valor. Da mesma forma, definir uma cor em runtime com o seletor de cores de guia substituirá essa cor.

Essa cor sempre é tratada como uma cor sólida, mesmo que definida como um terminalBackground de um painel com uma tela de fundo acrílico.

Quando definido como terminalBackground ou accent, isso usará automaticamente um valor alfa de 30%, para ser semitransparente.

Nome da propriedade:unfocusedBackground

Necessidade: Opcional

Aceita: uma cor de tema.

Mostrar o botão fechar

Configura como o botão "fechar" na guia deve aparecer. Isso aceita os seguintes valores:

  • "always": sempre mostrar os botões fechar da guia.
  • "hover": mostrar o botão fechar da guia na guia ativa e as guias estão focalizadas com o mouse.
  • "never": nunca mostrar os botões fechar da guia. Isso também desabilita a capacidade de fechar a guia com o botão do mouse do meio.
  • "activeOnly": mostrar o botão de fechar a guia somente na guia ativa.

Nome da propriedade:showCloseButton

Necessidade: Opcional

Aceita:"always", "hover", "never" e "activeOnly"

Valor padrão:"always"


Cores do tema

As cores usadas em temas aceitam valores de cor RGBA, bem como algumas cadeias de caracteres especiais para valores personalizados. Os valores aceitos são os seguintes:

  • "#rgb, "#rrggbb, "#rrggbbaa: um valor para a cor RGB. Quando o chanel alfa é omitido, essas cores são padrão para um canal alfa totalmente opaco.
  • "accent": esse é um valor especial que significa "a cor de ênfase definida nas configurações do sistema".
  • "terminalBackground": esse é um valor especial avaliado para querer dizer "a cor da tela de fundo do painel de terminal ativo". Se houver vários painéis em uma guia, essa será a cor do ativo. Isso sempre usa o background do perfil: ele ignora qualquer coisa de um backgroundImage, se definido.