Темы: выберите готовое оформление или добавьте свое.

1. 1Сохраните файл темы на телефоне. Он имеет расширение .json и размер меньше 64 KiB.
2. 2В Настройках откройте карточку Тема в разделе Оформление, нажмите Импорт и выберите файл.
3. 3Проверьте предпросмотр. Он показывает цвета обеих половин, форму, цвета терминала и отчет о контрастности. При слабой контрастности появляется предупреждение, но тему все равно можно применить. Файл с нарушениями правил отклоняется, и ничего не меняется.

Тема меняет только внешний вид приложения. Она не может выполнять код, загружать файлы или обращаться к серверу.

Устройство сохраняет до восьми импортированных тем. Импорт по ссылке отсутствует, и темы не синхронизируются между устройствами.

{
  "version": 2,
  "id": "harbour",
  "name": "Harbour",
  "author": "Collie",
  "light": {
    "background": "oklch(0.95 0.01 235)",
    "foreground": "oklch(0.26 0.025 250)",
    "card": "oklch(0.985 0.004 235)",
    "...": "..."
  },
  "dark": {
    "background": "oklch(0.21 0.018 250)",
    "foreground": "oklch(0.93 0.012 240)",
    "card": "oklch(0.255 0.02 252)",
    "...": "..."
  },
  "fonts": { "ui": "atkinson", "display": "grotesk" },
  "surface": {
    "radius": "soft",
    "shadow": "lifted",
    "density": "default",
    "weight": "default",
    "border": "default",
    "ground": "grain",
    "chrome": "page",
    "rows": "rules",
    "icons": "thin",
    "labels": "caps"
  },
  "ansi": {
    "0": "#073642",
    "1": "#f0504a",
    "2": "#859900",
    "...": "..."
  }
}

43 токена

Файл темы может содержать только эти токены, разделенные на четыре группы. Файл с любым другим ключом отклоняется.

Форма и оформление

Блок surface содержит десять слов. Каждое выбирается из закрытого списка, а пропущенный токен сохраняет значение по умолчанию, первое слово своего списка. Произвольные числа не принимаются, поэтому тема не может нарушить размер области нажатия.

radius

Угол карточки, строки, поля и кнопки.

• sharp
• soft
• round

shadow

Тень под приподнятыми панелями.

• default
• flat
• lifted

density

Объем пространства внутри элементов управления и между ними.

• default
• roomy

weight

Насколько насыщенно отображается текст medium и semibold.

• default
• bold

border

Толщина тонкой линии.

• default
• strong

ground

Фон под всеми элементами: сплошной цвет, мягкий градиент или мелкая зернистость.

• flat
• gradient
• grain

chrome

Заголовок и панели: на цвете страницы или на отдельной полосе.

• page
• band

rows

Список в виде одной группы в рамке с разделителями или в виде карточки для каждой строки.

• rules
• cards

icons

Толщина линий всех иконок.

• default
• thin
• heavy

labels

Мелкие подписи разделов: прописными буквами или как в предложении.

• caps
• sentence

Палитра терминала

Блок ansi содержит 18 цветов или не содержит ни одного: 16 цветов терминала, ink и ground. Каждый задается как #rrggbb или oklch(L C H) и проходит проверку.

Значения

Значение является цветом: #rrggbb, #rrggbbaa или oklch(L C H), с / A для прозрачности. L принимает значения от 0 до 1, C от 0 до 0.5 и H от 0 до 360, в виде обычных чисел.

Половины

Укажите light, dark или обе половины. Пропущенная половина заполняется из Collie, токен за токеном.

Шрифты

Необязательный параметр fonts.ui задает один из шрифтов, встроенных в ColliePWA. Необязательный параметр fonts.display задает шрифт для заголовков. Другие шрифты не принимаются.

Что отклоняется

Ключ не из списка, version отличная от 1 или 2, значение, не являющееся цветом или словом формы, var(), url() или любая другая функция, id встроенной темы, а также файл размером более 64 KiB. Сообщение указывает причину, и изменения не применяются.

Версия

Значение version: 1 или 2. В файле с блоком surface, начертанием fonts.display или блоком ansi указывается 2. Для файла версии 2 требуется ColliePWA 1.22.0 или новее.

Экспорт сохраняет активную тему в виде файла .collie-theme.json. Отправьте его кому-либо или сохраните в репозитории, и файл можно будет импортировать так же, как вы это сделали.

Подробности в Темы