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

CSS переменные

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

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

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

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

Root переменные

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

:root {
  --bs-blue: #0d6efd;
  --bs-indigo: #6610f2;
  --bs-purple: #6f42c1;
  --bs-pink: #d63384;
  --bs-red: #dc3545;
  --bs-orange: #fd7e14;
  --bs-yellow: #ffc107;
  --bs-green: #198754;
  --bs-teal: #20c997;
  --bs-cyan: #0dcaf0;
  --bs-white: #fff;
  --bs-gray: #6c757d;
  --bs-gray-dark: #343a40;
  --bs-gray-100: #f8f9fa;
  --bs-gray-200: #e9ecef;
  --bs-gray-300: #dee2e6;
  --bs-gray-400: #ced4da;
  --bs-gray-500: #adb5bd;
  --bs-gray-600: #6c757d;
  --bs-gray-700: #495057;
  --bs-gray-800: #343a40;
  --bs-gray-900: #212529;
  --bs-primary: #0d6efd;
  --bs-secondary: #6c757d;
  --bs-success: #198754;
  --bs-info: #0dcaf0;
  --bs-warning: #ffc107;
  --bs-danger: #dc3545;
  --bs-light: #f8f9fa;
  --bs-dark: #212529;
  --bs-primary-rgb: 13, 110, 253;
  --bs-secondary-rgb: 108, 117, 125;
  --bs-success-rgb: 25, 135, 84;
  --bs-info-rgb: 13, 202, 240;
  --bs-warning-rgb: 255, 193, 7;
  --bs-danger-rgb: 220, 53, 69;
  --bs-light-rgb: 248, 249, 250;
  --bs-dark-rgb: 33, 37, 41;
  --bs-white-rgb: 255, 255, 255;
  --bs-black-rgb: 0, 0, 0;
  --bs-body-rgb: 33, 37, 41;
  --bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", "Liberation Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));
  --bs-body-font-family: var(--bs-font-sans-serif);
  --bs-body-font-size: 1rem;
  --bs-body-font-weight: 400;
  --bs-body-line-height: 1.5;
  --bs-body-color: #212529;
  --bs-body-bg: #fff;
}

Компоненты переменных

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

Ознакомьтесь с документацией к нашей таблице, чтобы узнать, как мы используем CSS-переменные.

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

Примеры

Переменные 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.