Configurações de aparência no Terminal do Windows

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente das configurações de perfil. Elas devem ser colocadas na raiz do arquivo settings.json.

Idioma

Isso define uma substituição para o idioma preferencial do aplicativo.

Nome da propriedade: language

Necessidade: Opcional

Aceita: uma marca de linguagem BCP-47 como "en-US"


Tema

Isso define o tema (tema escuro ou tema claro) do aplicativo. O "system" usará o mesmo tema que o Windows.

Nome da propriedade: theme

Necessidade: Opcional

Aceita: "system", "dark", "light", nome do tema personalizado

Valor padrão: "system"



Sempre mostrar guias

Quando é definido como true, as guias são sempre exibidas. Quando é definido como false, e showTabsInTitlebar é definido como false, as guias são sempre exibidas abaixo da barra de título. Quando isso é definido como false e showTabsInTitlebar é definido como false, as guias só aparecem depois que mais de uma guia existe, digitando Ctrl+Shift+T ou digitando a associação de chave atribuída a newTab. Observe que a alteração dessa configuração exigirá a inicialização de uma nova instância de terminal.

Observação

Essa configuração não tem efeito quando showTabsInTitlebar é true.

Nome da propriedade: alwaysShowTabs

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Sempre mostrar guias no Terminal do Windows



Posição das guias recém-criadas (versão prévia)

Especifica onde novas guias aparecem na linha de tabulação. Quando é definido como "afterLastTab", novas guias aparecem no final da linha de tabulação. Quando é definido como "afterCurrentTab", novas guias aparecem após a guia atual.

Nome da propriedade: newTabPosition

Necessidade: Opcional

Aceita: "afterLastTab" e "afterCurrentTab"

Valor padrão: "afterLastTab"



Ocultar a barra de título

Quando definido como true, as guias são movidas para a barra de título e a barra de título desaparece. Quando definido como false, a barra de título fica acima das guias. Observe que a alteração dessa configuração exigirá a inicialização de uma nova instância de terminal.

Nome da propriedade: showTabsInTitlebar

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Mostrar guias do Terminal do Windows na barra de título



Mostrar textura acrílica na linha de guia

Quando esse valor estiver definido como true, a linha de guia receberá uma plano de fundo de textura acrílica com opacidade de 50%. Quando estiver definido como false, a linha de guia será opaca. Observe que a alteração dessa configuração exigirá a inicialização de uma nova instância de terminal.

Nome da propriedade: useAcrylicInTabRow

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Textura acrílica do Terminal do Windows na linha de guia



Usar o título do terminal ativo como título do aplicativo

Quando definido como true, a barra de título exibe o título da guia selecionada. Quando definido como false, a barra de título exibe "Terminal do Windows". Observe que a alteração dessa configuração exigirá a inicialização de uma nova instância de terminal.

Nome da propriedade: showTerminalTitleInTitlebar

Necessidade: Opcional

Aceita: true e false

Valor padrão: true



Modo sempre na parte superior

Quando o valor estiver definido como true, as janelas do Terminal do Windows serão abertas sobre todas as outras janelas da área de trabalho. Esse estado também pode ser alternado com a associação de teclas do toggleAlwaysOnTop.

Nome da propriedade: alwaysOnTop

Necessidade: Opcional

Aceita: true, false

Valor padrão: false



Modo de largura da guia

Define a largura das guias. O "equal" faz com que todas as guias tenham a mesma largura. O "titleLength" dimensiona cada guia para o comprimento do respectivo título. "compact" reduzirá cada guia inativa à largura do ícone, deixando na guia ativa mais espaço para exibir seu título completo.

Nome da propriedade: tabWidthMode

Necessidade: Opcional

Aceita: "equal", "titleLength" e "compact"

Valor padrão: "equal"

Modo de largura da guia do Terminal do Windows



Desabilitar animações de painel

Quando o valor estiver definido como true, isso desabilitará as animações visuais em todo o aplicativo.

Nome da propriedade: disableAnimations

Necessidade: Opcional

Aceita: true e false

Valor padrão: false



Mostrar o pop-up "fechar todas as guias"

Quando definido como true, fechar uma janela com várias guias abertas exigirá confirmação. Quando definido como false, fechar uma janela com várias guias abertas não exigirá confirmação.

Nome da propriedade: confirmCloseAllTabs

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Confirmação do Terminal do Windows para fechar todas as guias



Usar uma imagem de tela de fundo em toda a janela

Quando definida como true, a imagem de tela de fundo do perfil atualmente com foco é expandida para abranger toda a janela, abaixo de outros painéis. Esse é um recurso experimental e sua existência contínua não é garantida.

Nome da propriedade: experimental.useBackgroundImageForWindow

Necessidade: Opcional

Aceita: true e false

Valor padrão: false


Lista suspensa de nova guia

Essa configuração permite que você configure a lista de perfis e a estrutura do novo menu suspenso de guias. Isso permite que você reordene perfis, aninhe perfis em sub menus, oculte perfis e muito mais. A configuração newTabMenu aceita uma lista de "Entradas de menu de nova guia", que são descritas abaixo.

Um exemplo dessa configuração pode ser semelhante a:

{
    "newTabMenu": [
        { "type":"profile", "profile": "Command Prompt" },
        { "type":"profile", "profile": "Windows PowerShell" },
        { "type":"separator" },
        {
            "type":"folder",
            "name": "ssh",
            "icon": "C:\\path\\to\\icon.png",
            "entries":
            [
                { "type":"profile", "profile": "Host 1" },
                { "type":"profile", "profile": "8.8.8.8" },
                { "type":"profile", "profile": "Host 2" }
            ]
        },
        {
            "type": "folder",
            "name": "WSL",
            "entries": [ { "type": "matchProfiles", "source": "Microsoft.Terminal.Wsl" } ]
        },
        { "type": "remainingProfiles" }
    ]
}

Nome da propriedade: newTabMenu

Necessidade: Opcional

Aceita: uma lista de entradas de menu de nova guia

Valor padrão: [ { "type":"remainingProfiles" } ]

Entradas de menu de nova guia

Veja a seguir diferentes tipos de entradas de menu de nova guia que podem ser usadas na configuração newTabMenu. Cada uma delas está na forma de um objeto JSON com uma propriedade type e outras propriedades específicas para esse tipo de entrada. Os valores da propriedade type estão listados abaixo.

Profile

Esse tipo de entrada representa um perfil da lista de perfis. O perfil pode ser especificado por nome ou GUID.

{ "type":"profile", "profile": "Command Prompt" }
Parâmetros
Nome Necessidade Aceita Descrição
profile Necessário Nome ou GUID do perfil como uma cadeia de caracteres Perfil que será aberto com base no respectivo GUID ou nome.

Pasta

Esse tipo de entrada representa uma pasta aninhada no menu suspenso da nova guia. As pastas podem ser aninhadas dentro de outras pastas.

{
    "type":"folder",
    "name": "ssh",
    "icon": "C:\\path\\to\\icon.png",
    "entries":
    [
        { "type":"profile", "profile": "Host 1" },
        { "type":"profile", "profile": "Host 2" }
    ]
}
Parâmetros
Nome Necessidade Aceita Descrição
name Necessário Nome da pasta como uma cadeia de caracteres Nome da pasta, exibido na entrada do menu.
icon Opcional Caminho para um ícone como uma cadeia de caracteres Caminho para um ícone que será exibido ao lado do nome da pasta.
entries Obrigatório Lista de novas entradas de menu de guia Lista de novas entradas de menu de guia que serão exibidas quando a pasta for clicada.
allowEmpty Opcional Booliano (o padrão é true) Se definido como true, a pasta será exibida mesmo que não tenha entradas. Se definido como false, a pasta não será exibida se não tiver entradas. Isso pode ser útil com entradas matchProfiles.
inline Opcional Booliano (o padrão é false) Se definido como true, e houver apenas uma única entrada na pasta, essa pasta não criará um menu aninhado. Em vez disso, a entrada no menu será apenas a única entrada na pasta. Isso pode ser útil com entradas matchProfiles.

Separador

Esse tipo de entrada representa um separador no menu suspenso da nova guia.

{ "type":"separator" }

Perfis restantes

Esse tipo de entrada representa todos os perfis que ainda não estão representados no menu suspenso da nova guia. Isso é útil se você quiser ter um conjunto de perfis que sempre são exibidos na parte superior do menu suspenso da nova guia e, em seguida, ter o restante dos perfis exibidos em uma pasta na parte inferior do menu suspenso da nova guia.

Isso retornará uma lista dos perfis restantes, na ordem em que eles aparecerem na lista profiles.

{ "type": "remainingProfiles" }

Perfil de correspondência

Esse tipo de entrada é semelhante à entrada de perfis restantes. Essa entrada será expandida para uma lista de perfis que correspondem a uma determinada propriedade. Você pode corresponder com base nos perfis por name, commandline ou source.

Por exemplo:

{ "type": "matchProfiles", "source": "Microsoft.Terminal.Wsl" }

Criará um conjunto de entradas que são todos perfis com a propriedade source definida como Microsoft.Terminal.Wsl. Observe que a propriedade source é definida de perfis gerados automaticamente. Se você estiver criando manualmente um perfil e inserir uma propriedade de origem personalizada, ela não será reconhecida por matchProfiles e o perfil não aparecerá na lista.

Uma comparação de cadeia de caracteres completa é feita nessas propriedades – não uma correspondência de cadeia de caracteres regex ou parcial.

Parâmetros
Nome Necessidade Aceita Descrição
name Opcional Nome do perfil como uma cadeia de caracteres Um valor a ser comparado ao do perfil name.
commandline Opcional Linha de comando como uma cadeia de caracteres Um valor a ser comparado ao do perfil commandline.
source Opcional Origem do perfil como uma cadeia de caracteres Um valor a ser comparado ao do perfil source.