Перейти к основному содержанию Перейти к навигации по документам

CSS переменные

Используйте пользовательские свойства Bootstrap для быстрого и прогрессивного дизайна и разработки.

На этой странице

Bootstrap включает в себя множество настраиваемых свойств (переменных) CSS в свой скомпилированный CSS для настройки в реальном времени без необходимости перекомпилировать Sass. Они обеспечивают легкий доступ к часто используемым значениям, таким как цвета нашей темы, контрольные точки и стеки основных шрифтов, при работе в инспекторе браузера, в изолированной программной среде или при общем прототипировании.

Все наши настраиваемые свойства имеют префикс bs-, чтобы избежать конфликтов со сторонним CSS.

Корневые переменные

Вот переменные, которые мы включаем (обратите внимание, что требуется :root), к которым можно получить доступ везде, где загружен CSS Bootstrap. Они находятся в нашем файле _root.scss и включены в наши скомпилированные файлы dist.

По умолчанию

Эти переменные CSS доступны везде, независимо от цветового режима.

:root {
    scroll-behavior: smooth;
  }

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

Bootstrap 5 все чаще использует пользовательские свойства в качестве локальных переменных для различных компонентов. Таким образом мы уменьшаем наш скомпилированный CSS, гарантируем, что стили не наследуются в таких местах, как вложенные таблицы, и допускаем некоторые базовые изменения стиля и расширения компонентов Bootstrap после компиляции Sass.

Взгляните на нашу документацию по таблицам, чтобы узнать, как мы используем переменные CSS. Наши панели навигации также используют переменные CSS начиная с версии 5.2.0. Мы также используем переменные CSS в наших сетках — в первую очередь для отступов — новая CSS-сетка с опционом — с более широким использованием компонентов в будущем.

По возможности мы будем назначать переменные CSS на уровне базового компонента (например, .navbar для панели навигации и ее подкомпонентов). Это уменьшает количество предположений о том, где и как настраивать, и позволяет нашей команде легко вносить изменения в будущих обновлениях.

Префикс

Большинство переменных CSS используют префикс, чтобы избежать конфликтов с вашей собственной кодовой базой. Этот префикс является дополнением к --, который требуется для каждой переменной CSS.

Настройте префикс с помощью переменной Sass $prefix. По умолчанию установлено значение bs- (обратите внимание на тире в конце).

Примеры

Переменные CSS предлагают такую же гибкость, что и переменные Sass, но без необходимости компиляции перед отправкой в браузер. Например, здесь мы сбрасываем шрифт нашей страницы и стили ссылок с помощью переменных CSS.

body {
  font: 1rem/1.5 var(--bs-font-sans-serif);
}
a {
  color: var(--bs-blue);
}

Контрольные точки сетки

Хотя мы включаем контрольные точки нашей сетки как переменные CSS (кроме xs), имейте в виду, что переменные CSS не работают в медиа-запросах. Это предусмотрено спецификацией CSS для переменных, но может измениться в ближайшие годы с поддержкой переменных env(). Ознакомьтесь с этим ответом на Stack Overflow для некоторых полезных ссылок. Между тем, вы можете использовать эти переменные в других ситуациях CSS, а также в своем JavaScript.