Tokens de cor de tema do Visual Studio

O Visual Studio utiliza tokens de cor semânticos para definir a aparência de cada superfície de interface. Estes tokens fazem parte do sistema de design Fluent introduzido no Visual Studio 2026. Em vez de referenciarem cores hexadecimais específicas, cada controlo e superfície referenciam um token nomeado. Os temas fornecem valores para estes tokens, e todo o IDE atualiza-se em conformidade.

Esta referência lista todos os tokens de cor de tema disponíveis, o seu uso pretendido e os seus valores padrão nos temas Claro, Escuro e Alto Contraste. Use esta referência ao criar temas personalizados ou ao sobrescrever tokens individuais nas suas definições ou através do editor de cores do Tema .

Personalizar as cores dos temas no Visual Studio

O Visual Studio 2026 (18.7) inclui uma página de cores de tema no produto para personalizar os tokens de cor do tema Fluent. Use o comando Editar cores do tema , ou abra Ferramentas > Opções > Ambiente >> Experiência Visual Cores do tema. A página lista os tokens do tema ativo numa grelha pesquisável.

Selecione um token e escolha uma cor para aplicar a alteração imediatamente. Podes reiniciar um token individual sem remover as tuas outras personalizações. Os overrides são guardados separadamente para cada tema e sobrepostos ao tema selecionado, por isso mudar de tema também muda para os overrides guardados para esse tema. Dependendo dos tokens disponíveis, pode personalizar as cores do editor, janelas de ferramentas, shell Chrome, cabeçalhos de tabuladores, cabeçalhos de janelas e estados de interação como cores de hover.

Para definições de aparência mais amplas para o utilizador final, veja Alterar fontes, cores e temas no Visual Studio.

Partilha de sobreposições de temas

Para partilhar sobreposições de token, coloque um ficheiro JSON em %LOCALAPPDATA%\Microsoft\VisualStudio\18.0_xxxxxxxx\ColorThemes. O nome do ficheiro tem de corresponder ao tema para ser sobreposto. Por exemplo, dark.json sobrepõe-se ao tema das Trevas. Reinicie o Visual Studio para aplicar sobrescrições baseadas em ficheiros ao tema correspondente.

Como funcionam os tokens de tema

Cada token é um nome semântico que corresponde a um valor de cor. Os tokens estão organizados em duas categorias:

  • Shell (ShellColors) — tokens para controlos e superfícies comuns, derivados do sistema de design Windows 11 Fluent. Estes são botões de cobertura, caixas de texto, fundos, bordas, indicadores de estado e muito mais. Use estes tokens para um estilo geral da interface.
  • Shell interno (ShellInternalColors) — tokens para superfícies do Chrome do IDE, como a janela principal, barra de título, barra de estado e cabeçalhos da janela da ferramenta. Estes são expostos para sobreposições de tema, mas não são destinados ao estilo de controlo de extensão.

Formato do valor de cor

As cores são especificadas no #AARRGGBB formato (alfa, vermelho, verde, azul). Por exemplo, #B2FFFFFF é branco com ~70% opacidade.

Valores de Alto Contraste são índices de cor do sistema (por exemplo, 00000008 = WindowText). O Visual Studio resolve estes para o esquema de cores de Alto Contraste atual do utilizador em tempo de execução.

Comportamento de sobreposição

Os valores dos tokens fornecidos pelo tema são os valores base para o tema selecionado. Quando um utilizador altera um token no editor de cores do Tema, o Visual Studio aplica esse valor como uma camada de sobreposição por cima do tema selecionado. Remover ou reiniciar um override individual restaura o token ao valor base do tema selecionado sem afetar outros overrides.

Cores da concha

Estes tokens estilizam controlos e superfícies comuns em todo o Visual Studio. Seguem as mesmas convenções de nomenclatura que os recursos de temas Fluent do Windows 11.

Destaque

Fichas para elementos de cor de destaque, como botões principais, caixas de seleção selecionadas e indicadores ativos.

Token Description Light Escuro Alto Contraste
AccentFillAlt Fundo de acento alternativo, usado quando é necessário um tom diferente do Padrão #FF3F3682 #FFD2CCF8 0000000D
AccentFillDefault Fundo de sotaque padrão para elementos interativos, chamadas à ação e estados selecionados #FF5649B0 #FF9184EE 0000000D
AccentFillDisabled Fundo do sotaque com deficiência #37000000 #28FFFFFF 00000010
AccentFillSecondary Fundo de sotaque indica estado de hover #E55649B0 #E59184EE 0000000D
AccentFillSelectedTextBackground Contexto para texto selecionado em campos de texto ativo #FF0078D4 #FF005FB7 0000000D
AccentFillSelectedTextBackgroundSubtle Fundo de texto selecionado subtil, usado quando a cor do texto em primeiro plano não pode ser invertida #4D0078D4 #6660CDFF 0000000D
AccentFillSenary Fundo subtil de sotaque para estados além do Terciário #1F5649B0 #1F9184EE 0000000E
AccentFillTertiary Fundo de acento indica estado pressionado #CC5649B0 #CC9184EE 0000000D
AccentTextFillDisabled Texto de destaque e cor dos glifos desativados #5C000000 #5DFFFFFF 00000011
AccentTextFillPrimary Cor principal do texto de destaque para texto em primeiro plano e glifos que requerem ênfase #FF3F3682 #FFD2CCF8 00000002
AccentTextFillSecondary Texto de acento a indicar o estado de hover #FF221D46 #FFD2CCF8 00000002
AccentTextFillTertiary Texto de acento a indicar estado pressionado #FF5649B0 #FFA79CF1 00000002

Cartão

Tokens para superfícies semelhantes a cartões — blocos de conteúdo que ficam em fundos de página ou camadas.

Token Description Light Escuro Alto Contraste
CardBackgroundFillDefault Fundo padrão da carta #B2FFFFFF #0DFFFFFF 00000005
CardBackgroundFillSecondary Fundo do cartão a indicar o estado de hover #80F6F6F6 #08FFFFFF 00000005
CardBackgroundFillTertiary Fundo do cartão indica estado pressionado #FFFFFFFF #12FFFFFF 00000005
CardStrokeDefault Borda padrão da carta #0F000000 #1A000000 00000010
CardStrokeDefaultSolid Borda sólida de cartão, usada quando traços semitransparentes causam problemas de visibilidade #FFEBEBEB #FF1C1C1C 00000010
CardStrokeDefaultSolidAlt Borda alternativa de cartão sólido #FFDADADA #FF0A0A0A 00000010

Controlo

Fichas para controlos interativos padrão como botões, caixas de texto e caixas de combo.

Token Description Light Escuro Alto Contraste
ControlAltFillDisabled Histórico de controlo alternativo desativado #00FFFFFF #00FFFFFF 0000000F
ControlAltFillQuaternary Experiência de controlo alternativo de quarto nível #18000000 #12FFFFFF 0000000E
ControlAltFillSecondary Contexto de controlo alternativo de segundo nível #06000000 #1A000000 0000000E
ControlAltFillTertiary Experiência de controlo alternativo de terceiro nível #0F000000 #0BFFFFFF 0000000E
ControlAltFillTransparent Fundo de controlo alternativo transparente #00FFFFFF #00FFFFFF 0000000E
ControlFillActiveInput Controla o fundo durante a entrada ativa de texto #FFFFFFFF #B21E1E1E 0000000F
ControlFillDefault Fundo de controlo predefinido (estado resto) #B2FFFFFF #0FFFFFFF 0000000F
ControlFillDisabled Antecedentes de controlo desativados #4DF9F9F9 #0BFFFFFF 0000000F
ControlFillQuaternary Antecedentes de controlo de quarto nível #C2F3F3F3 #0FFFFFFF 0000000E
ControlFillSecondary Fundo de controlo de segundo nível (pairar) #80F9F9F9 #15FFFFFF 0000000E
ControlFillTertiary Fundo de controlo de terceiro nível (pressionado) #4DF9F9F9 #08FFFFFF 0000000E
ControlFillTransparent Fundo de controlo transparente #00FFFFFF #00FFFFFF 0000000F
ControlOnImageFillDefault Fundo de controlo predefinido quando colocado numa imagem #C9FFFFFF #B21C1C1C 0000000F
ControlOnImageFillDisabled Desativado o fundo de controlo quando colocado numa imagem #00FFFFFF #001E1E1E 0000000F
ControlOnImageFillSecondary Passar o botão de fundo do controlo do cursor quando colocado numa imagem #FFF3F3F3 #FF1A1A1A 0000000E
ControlOnImageFillTertiary Pressionou o fundo de controlo quando colocado numa imagem #FFEBEBEB #FF131313 0000000E
ControlSolidFillDefault Fundo sólido de controlo, usado quando a transparência causa problemas de visibilidade #FFFFFFFF #FF454545 0000000F
ControlStrokeDefault Fronteira de controlo padrão (estado de descanso) #0F000000 #12FFFFFF 00000010
ControlStrokeForStrongFillWhenOnImage Borda de controlo para preenchimentos fortes colocados nas imagens #59FFFFFF #6B000000 0000000A
ControlStrokeOnAccentDefault Borda padrão para controlos em fundos de acento #14FFFFFF #14FFFFFF 0000000B
ControlStrokeOnAccentDisabled Borda desativada para controlos em fundos de acento #0F000000 #33000000 0000000B
ControlStrokeOnAccentSecondary Borda de transição para controlos em fundos de acento #66000000 #24000000 0000000B
ControlStrokeOnAccentTertiary Borda pressionada para controlos nos fundos de acento #37000000 #37000000 0000000B
ControlStrokeSecondary Fronteira de controlo de segundo nível #0F000000 #12FFFFFF 00000008
ControlStrokeTransparent Fronteira de controlo transparente #00FFFFFF #00FFFFFF 0000000F
ControlStrongFillDefault Preenchimento de controlo forte para elementos de alto contraste como barras de scroll #72000000 #8BFFFFFF 0000000A
ControlStrongFillDisabled Preenchimento de controlo forte desativado #51000000 #3FFFFFFF 0000000F
ControlStrongStrokeDefault Borda de controlo forte para caixas de seleção e botões de opção #9C000000 #9AFFFFFF 00000008
ControlStrongStrokeDisabled Fronteira forte de controlo desativada #37000000 #28FFFFFF 0000000B

Divider

Token Description Light Escuro Alto Contraste
DividerStrokeDefault Divisor padrão e traço do separador #14000000 #15FFFFFF 00000011

Foco

Token Description Light Escuro Alto Contraste
FocusStrokeInner Traço indicador de foco interno #FFFFFFFF #B2000000 00000005
FocusStrokeOuter Traço do indicador de foco exterior #E4000000 #FFFFFFFF 00000008
Token Description Light Escuro Alto Contraste
HyperlinkFillDisabled Cor do texto do hiperlink desativado #5C000000 #5DFFFFFF 00000013
HyperlinkFillPrimary Cor do texto do hipervínculo principal (resto) #FF003E92 #FF99EBFF 0000001A
HyperlinkFillSecondary Cor do texto do hiperlink (passar o curso) #FF001A68 #FF60CDFF 0000001A
HyperlinkFillTertiary Cor do texto do hiperlink (pressionado) #FF005FB8 #E560CDFF 0000001A

Camada e superfície

Tokens para fundos, superfícies em camadas e recipientes ao nível da página.

Token Description Light Escuro Alto Contraste
LayerFillAlt Preenchimento alternativo de camada para superfícies #FFFFFFFF #0EFFFFFF 00000005
LayerFillDefault Preenchimento de camadas padrão para superfícies e barras de scroll #80FFFFFF #4D3A3A3A 00000005
SolidBackgroundFillBase Fundo sólido base para superfícies de página #FFF3F3F3 #FF202020 00000005
SolidBackgroundFillBaseAlt Base sólida alternativa #FFDADADA #FF0A0A0A 00000005
SolidBackgroundFillSecondary Formação secundária sólida (um nível acima da Base) #FFEEEEEE #FF1C1C1C 00000005
SolidBackgroundFillTertiary Formação sólida terciária #FFF9F9F9 #FF282828 00000005
SolidBackgroundFillQuaternary Formação sólida de quarto nível #FFFFFFFF #FF2C2C2C 00000005
SolidBackgroundFillQuinary Formação sólida do quinto nível #FFFDFDFD #FF333333 00000005
SolidBackgroundFillSenary Base sólida de sexto nível #FFFFFFFF #FF373737 00000005
SurfaceBackgroundFillDefault Fundo padrão para superfícies discretas acima da base #FFF9F9F9 #FF2C2C2C 00000005
SurfaceStrokeDefault Borda de superfície padrão #66757575 #66757575 0000000A
SurfaceStrokeFlyout Borda de superfície de flyout #0F000000 #33000000 0000000A

Sombra e fumo

Token Description Light Escuro Alto Contraste
ShadowFlyout Cor das sombras para superfícies de flyout como pop-ups, dicas de ferramentas e menus de contexto #24000000 #42000000 00000005
SmokeFillDefault Cor sobreposta de fumo para escurecer superfícies de fundo #4D000000 #4D000000 0000000F
SmokeFillInverse Cor inversa da sobreposição de fumo #C9FFFFFF #B21C1C1C 0000000F

Subtil

Tokens para controlos com peso visual mínimo, como botões da barra de ferramentas e itens do menu.

Token Description Light Escuro Alto Contraste
SubtleFillDisabled Preenchimento de controlo subtil desativado #00000000 #00FFFFFF 00000005
SubtleFillSecondary Preenchimento de controlo subtil (pairação) #0F000000 #0FFFFFFF 0000000F
SubtleFillTertiary Preenchimento de controlo subtil (pressionado) #0A000000 #0BFFFFFF 0000000F
SubtleFillTransparent Preenchimento de controlo subtil transparente #00FFFFFF #00FFFFFF 00000005

Estado do sistema

Tokens para indicadores de estado — atenção, cautela, crítico, sucesso e neutro.

Token Description Light Escuro Alto Contraste
SystemFillAttention Indicador de atenção, borda e traço (informativo) #FF005FB7 #FF60CDFF 00000002
SystemFillAttentionBackground Fundo do indicador de atenção #80F6F6F6 #08FFFFFF 00000018
SystemFillCaution Indicador de aviso de borda e curso #FF9D5D00 #FFFCE100 00000002
SystemFillCautionBackground Fundo do indicador de aviso #FFFFF4CE #FF433519 00000018
SystemFillCritical Bordura e traço do indicador de erro #FFC42B1C #FFFF99A4 00000002
SystemFillCriticalBackground Fundo do indicador de erro #FFFDE7E9 #FF442726 00000018
SystemFillNeutral Preenchimento do sistema neutro #72000000 #8BFFFFFF 00000002
SystemFillNeutralBackground Contexto do sistema neutro #06000000 #08FFFFFF 00000018
SystemFillSolidAttentionBackground Fundo sólido de atenção, usado quando a transparência causa problemas de visibilidade #FFF7F7F7 #FF2E2E2E 00000018
SystemFillSolidNeutral Preenchimento com indicador de neutro sólido #FF8A8A8A #FF8A8A8A 00000002
SystemFillSolidNeutralBackground Fundo neutro sólido #FFF3F3F3 #FF2E2E2E 00000018
SystemFillSuccess Borde do indicador de sucesso e stroke #FF0F7B0F #FF6CCB5F 00000002
SystemFillSuccessBackground Contexto do indicador de sucesso #FFDFF6DD #FF393D1B 00000018

Texto

Token Description Light Escuro Alto Contraste
TextFillDisabled Cor de texto desativada #5C000000 #5DFFFFFF 00000011
TextFillPrimary Cor principal do texto para conteúdo geral #E4000000 #FFFFFFFF 00000008
TextFillSecondary Cor do texto secundário para conteúdo suplementar e dicas #9E000000 #C8FFFFFF 00000008
TextFillTertiary Cor de texto terciário (baixo contraste — não usar para conteúdo primário em repouso) #72000000 #8BFFFFFF 00000008
TextOnAccentFillDisabled Texto desativado em fundos de sotaque #B2FFFFFF #80000000 00000003
TextOnAccentFillPrimary Texto primário sobre fundos de sotaque #FFFFFFFF #FF000000 0000000E
TextOnAccentFillSecondary Texto secundário sobre fundos de acento #B2FFFFFF #80000000 0000000E
TextOnAccentFillSelectedText Cor do texto para texto selecionado em fundos de destaque #FFFFFFFF #FFFFFFFF 0000000E

Cores internas da carcaça

Estes tokens controlam as superfícies do IDE Chrome — a moldura principal da janela, cabeçalhos da janela da ferramenta, separadores, barra de estado e outros elementos ao nível da shell. São os principais tokens que os autores de temas usam para mudar a sensação geral do IDE.

O Visual Studio adiciona tokens de cor fluentes à medida que as áreas do shell se tornam mais granulares. Tokens adicionais podem surgir para superfícies do Chrome, como cabeçalhos de tabulação e cabeçalhos de janelas, para que os autores de temas possam estilizar essas áreas independentemente de outros Chrome de shell.

Environment

Tokens que controlam a janela principal e as superfícies cromadas da shell.

Token Description Light Escuro Alto Contraste
EnvironmentBackground Fundo da janela principal e janelas de ferramentas flutuantes #FFEEEEEE #FF1C1C1C 00000005
EnvironmentBadge Informação da solução Insígnia de fundo (por exemplo, indicador de Live Share) #B2FFFFFF #0FFFFFFF 0000000F
EnvironmentBody Corpo/área de conteúdo da janela principal do shell #FFEEEEEE #FF1C1C1C 00000005
EnvironmentBodyText Cor do texto no corpo/área de conteúdo da janela principal do shell #E4000000 #FFFFFFFF 00000008
EnvironmentBorder Borda ativa da janela principal #FF5649B0 #FF9184EE 0000000A
EnvironmentBorderInactive Borda da janela principal inativa e divisórias internas #FFADADAD #FF454545 00000003
EnvironmentHeader Janela ativa ou fundo do cabeçalho da janela de ferramenta, separado dos fundos de separador #FFF9F9F9 #FF282828 00000005
EnvironmentHeaderInactive Fundo de cabeçalho de janela ou janela de ferramenta inativo, separado dos fundos de tabulação #FFF9F9F9 #FF282828 00000005
EnvironmentIndicator Borda ou indicador para separadores automáticos #66757575 #66757575 0000000A
EnvironmentLayeredBackground Fundo para elementos em camadas como InfoBars e grupos de separadores #80FFFFFF #4D3A3A3A 00000005
EnvironmentLayeredBorder Borda para elementos em camadas como InfoBars e emblemas #0F000000 #80000000 00000010
EnvironmentLogo O logótipo do Visual Studio preenche o menu do sistema #FF5649B0 #FF9184EE 0000000D
EnvironmentTab Ativo em fundo do cabeçalho de separação, separado dos cabeçalhos janela e ferramenta-janela #FFF9F9F9 #FF282828 00000005
EnvironmentTabInactive Fundo do cabeçalho de separador inativo, separado dos cabeçalhos janela e janela ferramenta #FFF9F9F9 #FF282828 00000005

Legenda

Tokens especificamente para o botão de fechar janela.

Token Description Light Escuro Alto Contraste
CaptionControlCloseFillPrimary Fechar fundo do botão (passar o rato) #FFC42B1C #FFC42B1C 0000000D
CaptionControlCloseFillSecondary Fechar fundo do botão (pressionado) #E6C42B1C #E6C42B1C 0000000D
CaptionControlCloseTextFillPrimary Ícone de botão fechar cor (passar o curso) #FFFFFFFF #FFFFFFFF 00000009
CaptionControlCloseTextFillSecondary Cor do ícone do botão fechar (pressionado) #B3FFFFFF #B3FFFFFF 00000009

Barra de status

Tokens para a barra de estado entre os seus diferentes modos.

Token Description Light Escuro Alto Contraste
StatusBarBackgroundFillBuilding Contexto da barra de estado durante a construção #FF5649B0 #FF3F3682 00000005
StatusBarBackgroundFillDebugging Fundo da barra de estado ao depurar #FFBC4B09 #FF7A2101 00000005
StatusBarBackgroundFillRest Fundo da barra de estado no estado padrão #8B000000 #4D000000 00000005
StatusBarBackgroundFillSolutionLoading Fundo da barra de estado ao carregar uma solução #FF005BA1 #FF003B6A 00000005
StatusBarControlFillSecondary Preenchimento de controlo secundário na barra de estado #33000000 #20FFFFFF 0000000E
StatusBarTextFillBuilding Texto da barra de estado ao construir #FFFFFFFF #FFFFFFFF 00000008
StatusBarTextFillDebugging Texto da barra de estado ao depurar #FFFFFFFF #FFFFFFFF 00000008
StatusBarTextFillDisabled Texto da barra de estado desativado #90FFFFFF #5DFFFFFF 00000011
StatusBarTextFillRest Texto da barra de estado no estado padrão #FFFFFFFF #FFFFFFFF 00000008
StatusBarTextFillSolutionLoading Texto da barra de estado ao carregar uma solução #FFFFFFFF #FFFFFFFF 00000008

Referência de cor do sistema High Contrast

Valores de Alto Contraste são índices de cor do sistema. O Visual Studio mapeia estes para o esquema de cores ativo de Alto Contraste do utilizador. Índices comuns:

Índice Cor do sistema
00000001 ActiveCaption
00000002 ActiveCaptionText
00000003 ActiveBorder
00000005 Window
00000008 WindowText
00000009 HotTrackColor
0000000A InactiveBorder
0000000B InactiveCaption
0000000D Highlight
0000000E HighlightText
0000000F ButtonFace
00000010 ButtonShadow
00000011 GrayText
00000013 InactiveCaptionText
00000018 GradientActiveCaption
0000001A HotLight