Перейти к содержимому
Авторский вебсайт. Ошибки и проблемы гарантированы❗

Фрагмент стиля 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-width1pxТолщина границ компонента интерфейса

Переменная цвета

Переменная 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-h258Акцентный тон (hue)
--accent-s88%Акцентная насыщенность (saturation)
--accent-l66%Акцентный светлота (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-rgb233, 49, 71251, 70, 76
--color-orange-rgb236, 117, 0233, 151, 63
--color-yellow-rgb224, 172, 0224, 222, 113
--color-green-rgb8, 185, 7868, 207, 110
--color-cyan-rgb0, 191, 18883, 223, 221
--color-blue-rgb8, 109, 2212, 122, 255
--color-purple-rgb120, 82, 238168, 130, 255
--color-pink-rgb213, 57, 132250, 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-0whiteblack
--mono-100blackwhite

Предупреждение

Не изменяйте значения переменных чёрного и белого цветов!

Семантические цвета формируют на основе базовой цветовой палитры с учетом назначения.

ПеременнаяОписание
--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-colorCaret color

Переменные курсора

Приложение Obsidian следует принятым в операционной системе стандартам оформления курсора. Для интерактивных элементов он использует курсор в виде стрелки, а не указателя.

ПеременнаяЗначениеОписание
--cursordefaultКурсор для интерактивных элементов
--cursor-linkpointerКурсор для ссылок

Переменные пиктограмм

Пиктограммы привлекают внимание и позволяют быстро найти нужный компонент графического интерфейса.

Приложение 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-xs14px
--icon-s16px
--icon-m18px
--icon-l18px
--icon-xl32px
--icon-xs-stroke-width2px
--icon-s-stroke-width2px
--icon-m-stroke-width1.75px
--icon-l-stroke-width1.75px
--icon-xl-stroke-width1.25px

Переменные слоёв

Слой (Layer) определяет глубину или z-индекс элемента.

ПеременнаяЗначение
--layer-cover5
--layer-sidedock10
--layer-status-bar15
--layer-popover30
--layer-slides45
--layer-modal50
--layer-notice60
--layer-menu65
--layer-tooltip70
--layer-dragged-item80

Переменные радиуса скругления углов

Радиус (Radius) определяет скругление углов элементов графического интерфейса.

ПеременнаяЗначение
--radius-s4px
--radius-m8px
--radius-l12px
--radius-xl16px

Переменные сетки

Для структурирования элементов интерфейса 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-14px
--size-4-28px
--size-4-312px
--size-4-416px
--size-4-520px
--size-4-624px
--size-4-832px
--size-4-936px
--size-4-1248px
--size-4-1664px
--size-4-1872px

Переменные типографики

Переменные шрифтов:

ПеременнаяОписание
--font-interface-themeШрифт интерфейса пользователя
--font-text-themeШрифт в редакторе текста
--font-monospace-themeМоноширинный шрифт блоков кода

Приложение Obsidian позволяет задавать относительные и абсолютные размеры шрифта (глифа):

  • --font-* — относительные переменные для редактора текста;
  • --font-ui-* — абсолютные переменные для компонентов графического интерфейса.
ПеременнаяЗначение
--font-text-size16px
--font-smallest0.8em
--font-smaller0.875em
--font-small0.933em
--font-ui-smaller12px
--font-ui-small13px
--font-ui-medium15px
--font-ui-large20px

Переменные насыщенности шрифта:

ПеременнаяЗначение
--font-thin100
--font-extralight200
--font-light300
--font-normal400
--font-medium500
--font-semibold600
--font-bold700
--font-extrabold800
--font-black900

Для управления насыщенностью можно использовать переменную --bold-modifier. Она позволяет усилить насыщенность уже насыщенного шрифта. Рекомендуемый диапазон значений переменной --bold-modifier от 100 до 300. Список переменных указания насыщенности:

ПеременнаяОписание
--font-weightНасыщенность шрифта основного текста
--bold-modifierДобавить насыщенность к уже насыщенному шрифту
--bold-weightНасыщенность шрифта
--bold-colorЦвет насыщенного шрифта
--italic-colorЦвет курсивного шрифта

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

ПеременнаяЗначениеОписание
--line-height-normal1.5Высота строки по умолчанию
--line-height-tight1.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-startstart отступ списка

Переменные поля ввода данных

Переменные выбора акцентного цвета:

ПеременнаяОписание
--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-spacewhite-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 файла

Дополнительные сведения