Compartir a través de

Configuración temática en Terminal Windows (versión preliminar)

  • Artículo

La configuración que se muestra a continuación afecta a los objetos visuales de la propia ventana del terminal, en lugar de la apariencia de una pestaña o panel individual. Actualmente, esta configuración solo se puede editar directamente en el archivo settings.json y no se puede configurar a través de la interfaz de usuario de configuración.

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

Para algunos temas de ejemplo, eche un vistazo a la galería de temas.

Cada tema de la lista themes se compone de una colección de objetos de propiedad, que especifican las propiedades de los elementos específicos de la aplicación. Por ejemplo, el tema "dark" predeterminado es el siguiente:

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

También puede configurar el Terminal para que use temas distintos para el modo claro y oscuro del sistema operativo y cambie automáticamente entre ellos cuando cambie el tema del sistema operativo. Para ello, especifique la propiedad theme como un objeto que contiene las claves light y dark:

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

Nombre del tema

Este es el nombre del tema. Los nombres deben ser únicos. Los nombres dark, light y system están reservados para los temas predeterminados integrados.

Nombre de la propiedad: name

Necesidad: Requerido

Acepta: nombre del tema como una cadena.


Periodo

Estas opciones se usan para configurar la apariencia de toda la ventana del Terminal.

Nombre de la propiedad: window

Tema de la aplicación

Establece el tema de la interfaz de usuario de la aplicación. Esto estilizará elementos como botones, la paleta de comandos y otros elementos de la interfaz de usuario de la aplicación. Puede ser claro u oscuro. "system" usará el mismo tema que Windows.

Nombre de la propiedad: applicationTheme

Necesidad: opcional

Acepta: "system", "dark", "light"

Valor predeterminado: "dark"

Mica

Esta opción habilita el efecto Mica en esta ventana, debajo de todas las demás capas de interfaz de usuario. Para que Mica sea visible, las capas que hay encima deben ser transparentes. Por ejemplo, para tener una fila de pestañas y dentro Mica, deberá configurar el canal alfa del fondo para que sea 0 del modo siguiente:

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

Tenga en cuenta que cuando Mica está habilitado para la ventana, lo está en la totalidad de la ventana, también como fondo para los paneles del terminal de la ventana. Esto significa que los perfiles que usan opacity sin useAcrylic habilitado se mostrarán en el nuevo fondo de Mica. Actualmente no es posible tener a la vez un fondo transparente no difuminado para el terminal y un fondo de Mica para las pestañas o fila de pestañas.

Nombre de la propiedad: useMica

Necesidad: opcional

Acepta: true, false

Valor predeterminado: false

Nota:

Mica solo está disponible en las compilaciones de Windows >= 22621.

Borde de la ventana

Esto establece el color del borde de la ventana, cuando la ventana está activa. Cuando se establece en null, el borde usará el color predeterminado para el tema del sistema operativo.

Nombre de la propiedad: frame

Necesidad: Opcional

Acepta: un color de tema

Valor predeterminado: null

Nota:

Los colores del borde de la ventana solo están disponibles en Windows 11.

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Borde de la ventana inactivo

Esto establece el color del borde de la ventana, cuando la ventana está inactivo. Cuando se establece en null, el borde usará el color predeterminado para el tema del sistema operativo.

Nombre de la propiedad: unfocusedFrame

Necesidad: Opcional

Acepta: un color de tema

Valor predeterminado: null

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Experimental: Borde de ventana Arco iris

Cuando se habilita, esta configuración hará que el borde de la ventana recorra los colores del arco iris. Es una característica experimental y no se garantiza su continuidad. Cuando esta configuración está habilitada, tendrá prioridad sobre frameyunfocusedFrame.

Terminal Windows con rainbowFrame habilitado

Nombre de la propiedad: experimental.rainbowFrame

Necesidad: opcional

Acepta: true, false

Valor predeterminado: false

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.


Fila de pestañas

Estas opciones se usan para configurar la apariencia de la fila de pestañas. Cuando showTabsInTitlebar es true (el valor predeterminado), configura la barra de título.

Nombre de la propiedad: tabRow

Color de fondo

Color de la fila de pestañas cuando la ventana está en primer plano.

Nombre de la propiedad: background

Necesidad: Opcional

Acepta: un color de tema.

Color de fondo inactivo

Color de la fila de pestañas cuando la ventana está inactiva.

Nombre de la propiedad: unfocusedBackground

Necesidad: Opcional

Acepta: un color de tema.


Tabulaciones

Se trata de una configuración que controla la apariencia de cada pestaña en el Terminal.

Nombre de la propiedad: tab

Color de fondo

Color de la pestaña activa. Si se establece tabColor en un perfil, se invalidará este valor. Del mismo modo, establecer un color en tiempo de ejecución con el selector de colores de pestañas invalidará este color.

Este color siempre se trata como un color sólido, incluso si se establece en un terminalBackground de un panel con un fondo acrílico.

Nombre de la propiedad: background

Necesidad: Opcional

Acepta: un color de tema.

Color de fondo inactivo

Color de las pestañas inactivas. Si se establece tabColor en un perfil, se invalidará este valor. Del mismo modo, establecer un color en tiempo de ejecución con el selector de colores de pestañas invalidará este color.

Este color siempre se trata como un color sólido, incluso si se establece en un terminalBackground de un panel con un fondo acrílico.

Cuando se establece en terminalBackground o accent, se usará automáticamente un valor alfa del 30 %, para ser semitransparente.

Nombre de la propiedad: unfocusedBackground

Necesidad: Opcional

Acepta: un color de tema.

Mostrar el botón Cerrar

Configura cómo debe aparecer el botón "Cerrar" de la pestaña. Esto acepta cualquiera de los valores siguientes:

  • "always": muestra siempre los botones de cierre de pestaña.
  • "hover": muestra el botón de cierre de pestaña en la pestaña activa y las pestañas por encima de las que se pasa con el mouse.
  • "never": nunca muestra los botones de cierre de pestaña. Esto también deshabilita la capacidad de cerrar la pestaña con el botón central del mouse.
  • "activeOnly": muestra el botón Cerrar pestaña solo en la pestaña activa.

Nombre de la propiedad: showCloseButton

Necesidad: opcional

Acepta: "always", "hover", "never", "activeOnly"

Valor predeterminado: "always"


Colores del tema

Los colores usados en los temas aceptan valores de color RGBA, así como algunas cadenas especiales para los valores personalizados. Los valores aceptados son los siguientes:

  • "#rgb, "#rrggbb, "#rrggbbaa: un valor de color RGB. Cuando se omite el canal alfa, estos colores se omiten de manera predeterminada en un canal alfa totalmente opaco.
  • "accent": se trata de un valor especial que significa "el color de énfasis establecido en la configuración del sistema".
  • "terminalBackground": se trata de un valor especial que se evalúa como "el color de fondo del panel de terminal activo". Si hay varios paneles en una pestaña, este es el color del que está activo. Esto siempre usa el background del perfil; omite cualquier cosa de un backgroundImage, si se establece.