Параметры темы в Терминале Windows (предварительная версия)

  • Статья

Приведенные ниже параметры относятся к визуальным элементам самого окна терминала, а не к оформлению отдельной вкладки или области. Сейчас эти параметры можно изменить только непосредственно в файле settings.json и нельзя настроить с помощью пользовательского интерфейса параметров.

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

Примеры тем можно найти в коллекции тем.

Каждая тема в списке themes состоит из коллекции объектов свойств, определяющих свойства отдельных элементов приложения. Например, тема "dark" по умолчанию представлена следующим образом:

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

Вы также можете настроить терминал для использования отдельных тем для светлого и темного режима в ОС и автоматически меняться между этими темами при изменении темы ОС. Для этого укажите theme свойство в качестве объекта, содержащего ключи light и dark:

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

Имя темы

Этот параметр позволяет задать имя темы. Имена должны быть уникальными. Имена dark, light и system зарезервированы для встроенных тем по умолчанию.

Имя свойства:name.

Необходимость: обязательный

Принимает: имя темы в виде строки


Окно

Эти параметры используются для настройки внешнего вида всего окна терминала.

Имя свойства:window.

Тема приложения

С помощью этого параметра задается тема пользовательского интерфейса приложения. В соответствии с темой приложения стилизуются кнопки, палитра команд и другие элементы пользовательского интерфейса приложения. Тема может быть светлой или темной. "system" будет использовать ту же тему, что и Windows.

Имя свойства:applicationTheme.

Степень необходимости: необязательно

Принимает:"system", "dark", "light".

Значение по умолчанию:"dark".

Mica

Это позволяет эффект Mica в этом окне под всеми другими слоями пользовательского интерфейса. Чтобы мика была видна, слои над ним должны быть прозрачными. Например, чтобы иметь строку вкладок с Mica в ней, необходимо настроить альфа-канал фона 0 следующим образом:

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

Обратите внимание, что если Mica включена для окна, она включена во всем окне, включая фон для панелей терминала в окне. Это означает, что профили, которые используются opacity без useAcrylic включения, будут отображаться в новом фоновом режиме Mica. В настоящее время не удается получить прозрачный прозрачный фон терминала и фон Mica для вкладок или строк табуляции одновременно.

Имя свойства:useMica.

Степень необходимости: необязательно

Принимает:true, false.

Значение по умолчанию:false.

Примечание.

Мика доступна только в сборках >Windows = 22621.

Граница окна

Этот параметр задает цвет границы окна, когда окно активно. Если задано значение null, граница будет использовать любой цвет по умолчанию для темы ОС.

Имя свойства:frame.

Степень необходимости: необязательно

Принимает:цвет темы

Значение по умолчанию:null.

Примечание.

Цвета границы окна доступны только в Windows 11.

Важно!

Эта функция доступна только в предварительной версии Терминала Windows.

Неактивная граница окна

Этот параметр задает цвет границы окна, если окно неактивно. Если задано значение null, граница будет использовать любой цвет по умолчанию для темы ОС.

Имя свойства:unfocusedFrame.

Степень необходимости: необязательно

Принимает:цвет темы

Значение по умолчанию:null.

Важно!

Эта функция доступна только в предварительной версии Терминала Windows.

Экспериментальный: граница окна Радуга

Если этот параметр включен, это приведет к циклию границы окна через цвета радуги. Это экспериментальная функция, ее поддержка в будущем не гарантируется. Если этот параметр включен, он будет иметь приоритет над обоими frame и unfocusedFrame.

The Windows Terminal with rainbowFrame enabled

Имя свойства:experimental.rainbowFrame.

Степень необходимости: необязательно

Принимает:true, false.

Значение по умолчанию:false.

Важно!

Эта функция доступна только в предварительной версии Терминала Windows.


Строка вкладок

Эти параметры используются для настройки оформления строки вкладок. Если для showTabsInTitlebar задано значение true (значение умолчанию), настраивается заголовок окна.

Имя свойства:tabRow.

Цвет фона

Цвет строки вкладок, если окно находится на переднем плане.

Имя свойства:background.

Степень необходимости: необязательно

Принимает:цвет темы.

Цвет фона в неактивном состоянии

Цвет строки вкладок, если окно неактивно.

Имя свойства:unfocusedBackground.

Степень необходимости: необязательно

Принимает:цвет темы.


Вкладки

Это параметры, которые управляют внешним видом отдельных вкладок в терминале.

Имя свойства:tab.

Цвет фона

Цвет активной вкладки. При установке tabColor в профиле это значение переопределяется. Аналогичным образом, при установке цвета во время выполнения с помощью средства выбора цвета вкладки этот цвет переопределяется.

Этот цвет всегда рассматривается как сплошной, даже если для панели с акриловым фоном установлено значение terminalBackground.

Имя свойства:background.

Степень необходимости: необязательно

Принимает:цвет темы.

Цвет фона в неактивном состоянии

Цвет неактивных вкладок. При установке tabColor в профиле это значение переопределяется. Аналогичным образом, при установке цвета во время выполнения с помощью средства выбора цвета вкладки этот цвет переопределяется.

Этот цвет всегда рассматривается как сплошной, даже если для панели с акриловым фоном установлено значение terminalBackground.

Если задано значение terminalBackground или accent, автоматически будет использоваться альфа-фактор 30 %, чтобы задать полупрозрачность.

Имя свойства:unfocusedBackground.

Степень необходимости: необязательно

Принимает:цвет темы.

Отображение кнопки "Закрыть"

Этот параметр отвечает за то, как именно будет отображаться кнопка "Закрыть". Параметр принимает любое из следующих значений:

  • "always": кнопки "Закрыть" всегда отображаются на вкладках.
  • "hover": кнопка "Закрыть" отображается на активной вкладке и любой вкладке, на которую наведен указатель мыши.
  • "never": кнопки "Закрыть" никогда не отображаются на вкладках. Кроме того, при этом отключается возможность закрыть вкладку с помощью средней кнопки мыши.
  • "activeOnly": кнопка закрытия вкладки только на активной вкладке.

Имя свойства:showCloseButton.

Степень необходимости: необязательно

Принимает:"always", "hover", "never", "activeOnly".

Значение по умолчанию:"always".


Цвета в темах

Цвета, используемые в темах, принимают значения RGBA, а также несколько специальных строк для пользовательских значений. Допустимые значения:

  • "#rgb, "#rrggbb, "#rrggbbaa — значение цвета RGB. Если альфа-канал не указан, для этих цветов по умолчанию используется полностью непрозрачный альфа-канал.
  • "accent" — это специальное значение, которое означает "набор цветов элементов в параметрах системы".
  • "terminalBackground" — это специальное значение, которое означает "цвет фона активной области терминала". Если на вкладке есть несколько областей, это цвет активной области. При этом всегда используется background профиля. Если параметр указан, любое значение из backgroundImage игнорируется.