Фрагмент стиля CSS
Ключевые понятия
Стиль оформления интерфейса (Theme) — способы (правила, параметры) описания внешнего вида компонента графического интерфейса приложения, не затрагивая структуру и разметку заметок.
Переменная стиля (CSS-переменная) — именованная переменная оформления компонента. Изменяя значение переменной можно изменять внешний вид компонента.
Место расположения файлов
Пользователь имеет возможность изменить оформление некоторых компонентов приложения без создания полноценной темы. Для описания стилей используют язык CSS.
Приложение Obsidian ищет фрагменты оформления в каталоге /.obsidian/snippets конфигурации хранилища заметок.
Переменные стиля
Приложение Obsidian содержит переменные CSS, значительно упрощающие изменение оформления графического интерфейса. Кроме того, использование переменных гарантированно обеспечивает совместимость фрагмента оформления с графическим интерфейсом Obsidian. Например,
.todo-list {
background-color: var(--background-secondary);
}Для частичного изменения темы по умолчанию достаточно указать стили, которые переопределят только указанные значения. Никаких сложных селекторов создавать нет необходимости. Например,
.theme-dark {
--background-primary: #18004F;
--background-secondary: #220070;
}
.theme-light {
--background-primary: #ECE4FF;
--background-secondary: #D9C9FF;
}Основные переменные стиля
Рассмотрим подробнее переменные для изменения цвета, пробелов, типографики.
Переменная границ
| Переменная | Значение | Описание |
|---|---|---|
--border-width | 1px | Толщина границ компонента интерфейса |
Переменная цвета
Переменная Colors задаёт диапазон цветов интерфейса. По умолчанию в качестве основных цветов выбрана нейтральная палитра от светлых до тёмных оттенков.
| Переменная | Светлая тема | Тёмная тема |
|---|---|---|
--color-base-00 | #ffffff | #1c1c1c |
--color-base-05 | #fcfcfc | #212121 |
--color-base-10 | #fafafa | #232323 |
--color-base-20 | #f6f6f6 | #282828 |
--color-base-25 | #efefef | #2e2e2e |
--color-base-30 | #e4e4e4 | #333333 |
--color-base-35 | #dadada | #3f3f3f |
--color-base-40 | #bdbdbd | #555555 |
--color-base-50 | #ababab | #666666 |
--color-base-60 | #707070 | #999999 |
--color-base-70 | #5c5c5c | #b3b3b3 |
--color-base-100 | #222222 | #dadada |
Акцентный цвет используют для привлечения внимания к интерактивным элементам. Без написания фрагмента стиля пользователь может изменить значение в разделе: Settings (Настройки) →
Appearance (Внешний вид) → Accent color (Акцентный цвет).
| Переменная | Значение | Описание |
|---|---|---|
--accent-h | 258 | Акцентный тон (hue) |
--accent-s | 88% | Акцентная насыщенность (saturation) |
--accent-l | 66% | Акцентный светлота (lightness) |
Значения --accent-h, --accent-s, --accent-l комбинируют в следующих переменных акцентного цвета:
--color-accent— акцентный цвет;--color-accent-1— смещенный акцентный тон, используемый для состояний наведения и активности;--color-accent-2— дополнительно смещенный акцентный тон, используемый для состояний наведения и активности.
Совет
Используйте CSS calculations вычисления для создания различных оттенков акцентного цвета.
Переменные дополнительных цветов использую в сообщениях состояния (ошибки, предупреждения, успешное выполнение), выносок, синтаксиса, узлов графа и элементов канвы (Canva). Эти переменные дополнены суффиксом -rgb, а для задания прозрачности — rgba.
| Переменная | Светлая тема | Тёмная тема |
|---|---|---|
--color-red | #e93147 | #fb464c |
--color-orange | #ec7500 | #e9973f |
--color-yellow | #e0ac00 | #e0de71 |
--color-green | #08b94e | #44cf6e |
--color-cyan | #00bfbc | #53dfdd |
--color-blue | #086ddd | #027aff |
--color-purple | #7852ee | #a882ff |
--color-pink | #d53984 | #fa99cd |
--color-red-rgb | 233, 49, 71 | 251, 70, 76 |
--color-orange-rgb | 236, 117, 0 | 233, 151, 63 |
--color-yellow-rgb | 224, 172, 0 | 224, 222, 113 |
--color-green-rgb | 8, 185, 78 | 68, 207, 110 |
--color-cyan-rgb | 0, 191, 188 | 83, 223, 221 |
--color-blue-rgb | 8, 109, 221 | 2, 122, 255 |
--color-purple-rgb | 120, 82, 238 | 168, 130, 255 |
--color-pink-rgb | 213, 57, 132 | 250, 153, 205 |
Например, в следующем фрагменте кода стандартную переменную используют для задания цвета текста, а RGB-переменную — для установки красного цвета фона с прозрачностью 20%.
color: var(--color-red);
background-color: rgba(var(--color-red-rgb), 0.2);Устаревшие переменные RGB и HSL
Приложение Obsidian использует цветовое пространство OKLCH. Не применяйте следующие переменные:
--color-red-rgb, --color-orange-rgb, --color-yellow-rgb, --color-green-rgb, --color-cyan-rgb, --color-blue-rgb, --color-purple-rgb, --color-pink-rgb
--color-accent-hsl
--mono-rgb-0, --mono-rgb-100
--interactive-accent-hsl
--background-modifier-error-rgb, --background-modifier-success-rgb
--text-highlight-bg-rgb
Чёрный и белый цвета позволяют создать маски с разной степенью непрозрачности.
| Переменная | Светлая тема | Тёмная тема |
|---|---|---|
--mono-0 | white | black |
--mono-100 | black | white |
Предупреждение
Не изменяйте значения переменных чёрного и белого цветов!
Семантические цвета формируют на основе базовой цветовой палитры с учетом назначения.
| Переменная | Описание |
|---|---|
--background-primary | Основной фон |
--background-primary-alt | Фон поверхности, расположенной поверх основного фона |
--background-secondary | Вторичный фон |
--background-secondary-alt | Фон поверхности, расположенной поверх вторичного фона |
--background-modifier-hover | Фон элемента при наведении курсора |
--background-modifier-active-hover | Фон активного элемента |
--background-modifier-border | Цвет границы |
--background-modifier-border-hover | Цвет границы при наведении курсора |
--background-modifier-border-focus | Цвет границы фокусного элемента |
--background-modifier-error-rgb | Фон ошибки, значение RGB |
--background-modifier-error | Фон ошибки |
--background-modifier-error-hover | Фон ошибки при наведении курсора |
--background-modifier-success-rgb | Фон успешного выполнения, значение RGB |
--background-modifier-success | Фон успешного выполнения |
--background-modifier-message | Фон сообщения |
--background-modifier-form-field | Фон поля формы |
Цвета интерактивных компонентов графического интерфейса:
| Переменная | Описание |
|---|---|
--interactive-normal | Фон стандартного интерактивного элемента |
--interactive-hover | Фон интерактивного элемента при наведении курсора |
--interactive-accent | Фон акцентного интерактивного элемента |
--interactive-accent-hsl | Фон акцентного интерактивного элемента (модель HSL) |
--interactive-accent-hover | Фон акцентного интерактивного элемента при наведении курсора |
Цвет различных фрагментов текста:
| Переменная | Описание |
|---|---|
--text-normal | Нормальный цвет текста |
--text-muted | Приглушенный текст |
--text-faint | Бледный текст |
--text-on-accent | Тёмный акцентный текст на акцентном фоне |
--text-on-accent-inverted | Светлый акцентный текст на акцентном фоне |
--text-success | Цвет текста об успешном выполнении |
--text-warning | Цвет предупреждения |
--text-error | Цвет текста об ошибке |
--text-accent | Акцентный цвет текста |
--text-accent-hover | Акцентный цвет текста при наведении курсора |
Цвето фона различных фрагментов текста:
| Переменная | Описание |
|---|---|
--text-selection | Фон выбранного фрагмента текста |
--text-highlight-bg | Фоновая подсветка текста |
Цвет курсора — мигающего символа, обозначающего место вставки текста:
| Переменная | Описание |
|---|---|
--caret-color | Caret color |
Переменные курсора
Приложение Obsidian следует принятым в операционной системе стандартам оформления курсора. Для интерактивных элементов он использует курсор в виде стрелки, а не указателя.
| Переменная | Значение | Описание |
|---|---|---|
--cursor | default | Курсор для интерактивных элементов |
--cursor-link | pointer | Курсор для ссылок |
Переменные пиктограмм
Пиктограммы привлекают внимание и позволяют быстро найти нужный компонент графического интерфейса.
Приложение Obsidian использует библиотеку пиктограмм Lucide.
Переменные свойств пиктограммы:
| Переменная | Описание |
|---|---|
--icon-size | Ширина и высота пиктограммы |
--icon-stroke | Толщины обводки |
--icon-color | Цвет пиктограммы |
--icon-color-hover | Цвет при наведении курсора |
--icon-color-active | Цвет активной пиктограммы |
--icon-color-focused | Цвет фокусной пиктограммы |
--icon-opacity | Прозначность |
--icon-opacity-hover | Прозрачность при наведении курсора |
--icon-opacity-active | Прозрачность активной пиктограммы |
--clickable-icon-radius | Радиус кнопки с пиктограммой |
Переменные размера пиктограммы:
| Переменная | Значение |
|---|---|
--icon-xs | 14px |
--icon-s | 16px |
--icon-m | 18px |
--icon-l | 18px |
--icon-xl | 32px |
--icon-xs-stroke-width | 2px |
--icon-s-stroke-width | 2px |
--icon-m-stroke-width | 1.75px |
--icon-l-stroke-width | 1.75px |
--icon-xl-stroke-width | 1.25px |
Переменные слоёв
Слой (Layer) определяет глубину или z-индекс элемента.
| Переменная | Значение |
|---|---|
--layer-cover | 5 |
--layer-sidedock | 10 |
--layer-status-bar | 15 |
--layer-popover | 30 |
--layer-slides | 45 |
--layer-modal | 50 |
--layer-notice | 60 |
--layer-menu | 65 |
--layer-tooltip | 70 |
--layer-dragged-item | 80 |
Переменные радиуса скругления углов
Радиус (Radius) определяет скругление углов элементов графического интерфейса.
| Переменная | Значение |
|---|---|
--radius-s | 4px |
--radius-m | 8px |
--radius-l | 12px |
--radius-xl | 16px |
Переменные сетки
Для структурирования элементов интерфейса Obsidian использует сетку с шагом 4 пикселя. Использование значений, кратных четырём, для внутренних (padding) и внешних (margin) отступов обеспечивает удобные пропорции макета. Приложение корректно масштабирует графический интерфейс на экранах с разной плотностью пикселей (DPI).
Для соблюдения сетки с шагом 4 пикселя при задании отступов следует использовать предопределенные CSS-переменные --size. Каждая переменная размера содержит два числа: базовое значение и множитель:
--size-4-1соответствует 4px (4 × 1);--size-4-2соответствует 8px (4 × 2);--size-4-4соответствует 16px (4 × 4).
Помимо сетки с шагом 4 пикселя, в Obsidian также предусмотрен набор переменных, основанных на сетке с шагом 2 пикселя.
Предупреждение
По возможности не используйте сетку с шаком 2 пикселя! При наложении стилей плагинов это может привести к поломке интерфейса.
| Переменная | Значение |
|---|---|
--size-4-1 | 4px |
--size-4-2 | 8px |
--size-4-3 | 12px |
--size-4-4 | 16px |
--size-4-5 | 20px |
--size-4-6 | 24px |
--size-4-8 | 32px |
--size-4-9 | 36px |
--size-4-12 | 48px |
--size-4-16 | 64px |
--size-4-18 | 72px |
Переменные типографики
Переменные шрифтов:
| Переменная | Описание |
|---|---|
--font-interface-theme | Шрифт интерфейса пользователя |
--font-text-theme | Шрифт в редакторе текста |
--font-monospace-theme | Моноширинный шрифт блоков кода |
Приложение Obsidian позволяет задавать относительные и абсолютные размеры шрифта (глифа):
--font-*— относительные переменные для редактора текста;--font-ui-*— абсолютные переменные для компонентов графического интерфейса.
| Переменная | Значение | |
|---|---|---|
--font-text-size | 16px | |
--font-smallest | 0.8em | |
--font-smaller | 0.875em | |
--font-small | 0.933em | |
--font-ui-smaller | 12px | |
--font-ui-small | 13px | |
--font-ui-medium | 15px | |
--font-ui-large | 20px |
Переменные насыщенности шрифта:
| Переменная | Значение |
|---|---|
--font-thin | 100 |
--font-extralight | 200 |
--font-light | 300 |
--font-normal | 400 |
--font-medium | 500 |
--font-semibold | 600 |
--font-bold | 700 |
--font-extrabold | 800 |
--font-black | 900 |
Для управления насыщенностью можно использовать переменную --bold-modifier. Она позволяет усилить насыщенность уже насыщенного шрифта. Рекомендуемый диапазон значений переменной --bold-modifier от 100 до 300. Список переменных указания насыщенности:
| Переменная | Описание |
|---|---|
--font-weight | Насыщенность шрифта основного текста |
--bold-modifier | Добавить насыщенность к уже насыщенному шрифту |
--bold-weight | Насыщенность шрифта |
--bold-color | Цвет насыщенного шрифта |
--italic-color | Цвет курсивного шрифта |
Переменные высоты строки:
| Переменная | Значение | Описание |
|---|---|---|
--line-height-normal | 1.5 | Высота строки по умолчанию |
--line-height-tight | 1.3 | Высота строки для поиска, иерархии, подсказок |
Переменные интервала между абзацами:
| Переменная | Описание |
|---|---|
--heading-spacing | Интервал над заголовоком |
--p-spacing | Интервал между абзацами |
Переменные компонентов интерфейса
Интерактивные компоненты графического интерфейса имеют собственные переменные.
Переменная кнопки
| Переменная | Описание |
|---|---|
--button-radius | Радиус скругления кнопки |
Переменные проверочного списка
| Переменная | Описание |
|---|---|
--checkbox-radius | Радиус |
--checkbox-size | Высота и ширина |
--checkbox-marker-color | Цвет маркера списка |
--checkbox-color | Цвет фора |
--checkbox-color-hover | Цвет фона при наведении курсора |
--checkbox-border-color | Цвет границ маркера пустого пункта |
--checkbox-border-color-hover | Цвет границ маркера пустого пункта при наведении курсора |
--checklist-done-decoration | Цвет маркера непустого пункта |
--checklist-done-color | Цвет текста непустого пункта |
--checkbox-margin-inline-start | start отступ списка |
Переменные поля ввода данных
Переменные выбора акцентного цвета:
| Переменная | Описание |
|---|---|
--swatch-radius | Радиус образца цвета |
--swatch-height | Высота образца цвета |
--swatch-width | Ширина образца цвета |
--swatch-shadow | Тень образца цвета |
Переменные диалога
Диалоговое окно — уменьшенная версия модального окна, которую применяют в основном для подтверждения действия.
| Переменная | Описание |
|---|---|
--dialog-width | Ширина диалогового окна |
--dialog-max-width | Максимальная ширина диалогового окна |
--dialog-max-height | Максимальная высота диалогового окна |
Переменные выпадающего списка
Переменные выпадающего списка и элементов выбора.
| Переменная | Описание |
|---|---|
--dropdown-background | Цвет фона |
--dropdown-background-blend-mode | Режим наложения фона |
--dropdown-background-hover | Цвета фона наведения курсора |
--dropdown-background-position | Позиция фона |
--dropdown-background-size | Размер фона |
--dropdown-padding | Внутренний отступ |
Переменные направляющих линий
| Переменная | Описание |
|---|---|
--indentation-guide-width | Ширина границы направляющей отступа |
--indentation-guide-width-active | Ширина активной границы направляющей отступа |
--indentation-guide-color | Цвет границы направляющей отступа |
--indentation-guide-color-active | Цвет активной границы направляющей отступа |
--indentation-guide-editing-indent | Ширина отступа в режиме редактирования |
--indentation-guide-reading-indent | Ширина отступа в режиме просмотра |
--indentation-guide-source-indent | Ширина отступа в режиме исходного кода |
Переменные модальных окон
К модальным окнам относят окна диалога и настроек.
| Переменная | Описание |
|---|---|
--modal-background | Цвет фона модального окна |
--modal-width | Ширина по умолчанию модального окна |
--modal-height | Высота по умолчанию модального окна |
--modal-max-width | Максимальная ширина модального окна |
--modal-max-height | Максимальная высота модального окна |
--modal-max-width-narrow | Максимальная ширина узкого модального окна |
--modal-border-width | Толщина границы модального окна |
--modal-border-color | Цвет границы модального окна |
--modal-radius | Радиус модального окна |
--modal-community-sidebar-width | Ширина панели плагина |
Переменные множественного выбра
К переменным множественного выбора относят медаданные заметки.
| Переменная | Описание |
|---|---|
--pill-color | Цвет текстового поля |
--pill-color-hover | Цвет текстового поля при наведении курсора |
--pill-color-remove | Цвет текстового поля при удалении |
--pill-color-remove-hover | Цвет текстового поля при удалении и при наведении курсора |
--pill-decoration | Оформление текстового поля |
--pill-decoration-hover | Оформление текстового поля при наведении курсора |
--pill-background | Цвет фона поля |
--pill-background-hover | Цвет фона поля при наведении курсора |
--pill-border-color | Цвет границы поля |
--pill-border-color-hover | Цвет границы поля при наведении курсора |
--pill-border-width | Ширина границы поля |
--pill-padding-x | Внутренний отступ слева-справа поля |
--pill-padding-y | Внутренний отступ сверху-снизу поля |
--pill-radius | Радиус скругления угла поля |
--pill-weight | Насыщенность шрифта поля |
Переменные навигации
Переменные навигации затрагивают оформление файлов и каталогов в файловом проводнике.
| Переменная | Описание |
|---|---|
--nav-item-size | Размер шрифта элемента навигации |
--nav-item-color | Цвет текста элемента навигации |
--nav-item-color-hover | Цвет текста элемента навигации при наведении курсора |
--nav-item-color-active | Цвет текста активного элемента навигации |
--nav-item-color-selected | Цвет текста выбранного элемента навигации |
--nav-item-color-highlighted | Цвет текста подсвеченного элемента навигации |
--nav-item-background-hover | Цвет фора элемента навигации при наведении курсора |
--nav-item-background-active | Цвет фона активного элемента навигации |
--nav-item-background-selected | Цвет фона выбранного элемента навигации |
--nav-item-padding | Внутренний отступ элемента навигации |
--nav-item-parent-padding | Внутренний отступ родительского элемента навигации |
--nav-item-children-padding-start | Внутренний отступ дочернего (start) элемента навигации |
--nav-item-children-margin-start | Внешний отступ дочернего (start) элемента навигации |
--nav-item-weight | Насыщенность шрифта элемента навигации |
--nav-item-weight-hover | Насыщенность шрифта элемента навигации при наведении курсора |
--nav-item-weight-active | Насыщенность шрифта активного элемента навигации |
--nav-item-white-space | white-space элемента навигации |
--nav-indentation-guide-width | Ширина границы направляющей линии элемента навигации |
--nav-indentation-guide-color | Цвет границы направляющей линии элемента навигации |
--nav-collapse-icon-color | |
--nav-collapse-icon-color-collapsed | Цвет шеврона свёрнутого элемента навигации |
Переменные всплывающих окон
| Переменная | Описание |
|---|---|
--popover-width | Ширина по умолчанию всплывающего окна |
--popover-height | Высота по умолчанию всплывающего окна |
--popover-max-height | Максимальная высотавсплывающего окна |
--popover-font-size | Размер шрифта всплывающего окна |
--popover-pdf-width | Ширина просмотра PDF файла |
--popover-pdf-height | Высота просмотра PDF файла |