> ## Documentation Index
> Fetch the complete documentation index at: https://ziva.zeleza.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Цветовые схемы

> Как настраивать цвета Ziva и адаптировать вывод под разные терминалы

# Цветовые схемы Ziva

Ziva построен на библиотеке [Lip Gloss](https://github.com/charmbracelet/lipgloss). Вы можете использовать как готовые цвета, так и свои значения.

## Предустановленные цвета Ziva

В пакете экспортируются удобные константы:

```go theme={null}
ziva.GreenBright
ziva.BlueDark
ziva.OrangeBright
ziva.GrayDark
// и другие
```

Их можно использовать при настройке очередей и собственных элементов интерфейса.

```go theme={null}
queue := ziva.NewQueue("Настройка")
queue.WithAppNameColor(ziva.CyanBright, true)
queue.WithTitleColor(ziva.GrayBright, false)
```

## Пользовательские цвета Lip Gloss

Вы можете передать любой цвет в формате HEX или именованного значения, поддерживаемого терминалом:

```go theme={null}
headerColor := lipgloss.Color("#7C3AED")
queue.WithAppNameColor(headerColor, true)
```

<Info>
  В 256-цветных терминалах HEX будет приведён к ближайшему доступному цвету. Для точного контроля используйте значения из таблиц Xterm.
</Info>

## Цвета ошибок

По умолчанию Ziva подсвечивает ошибки красным, предупреждения — жёлтым. Настройте их глобально:

```go theme={null}
ziva.SetErrorColor(
    lipgloss.Color("#FFB703"), // текст ошибки
    lipgloss.Color("#FB8500"), // ярлык статуса
)

// … позже можно вернуть значения по умолчанию
ziva.ResetErrorColors()
```

Если нужно использовать разные схемы для отдельных очередей, включайте/выключайте цвета перед запуском `queue.Run()`.

## ASCII-режим и отсутствие цвета

Для терминалов без поддержки цвета вызовите:

```go theme={null}
ziva.EnableASCIIMode()
ziva.EnableEmbeddedMode() // также включает более мягкую палитру
```

Это заменит символы псевдографики на ASCII и переключит стили в безопасные.

## Рекомендации по дизайну

* **Контраст.** Проверяйте вывод на светлой и тёмной темах (жива использует обычный текст + ANSI). Выбирайте пары цветов, читаемые в обоих вариантах.
* **Цвета статусов.** Используйте зелёный / жёлтый / красный для статусов «успех / предупреждение / ошибка», чтобы не ломать привычную семантику.
* **Минимум цветов.** Чем меньше оттенков, тем проще воспринимать интерфейс. Обычно достаточно базового цвета приложения, цвета заголовка и цветов статусов.
* **Тестирование.** Проверяйте вывод в разных эмуляторах терминала (iTerm2, GNOME Terminal, Windows Terminal). Некоторые из них ограничивают палитру до 16 цветов.

## Связанные разделы

* [Стили и шрифты](/ru/customization/styling)
* [Встроенные режимы для MCUs и роутеров](/ru/customization/embedded-systems)