Составные части
Узнайте, как и почему мы создаем почти все наши компоненты быстро и с помощью базовых классов и классов-модификаторов.
Базовые классы
Компоненты Bootstrap в основном построены с использованием номенклатуры базовых модификаторов. Мы группируем как можно больше общих свойств в базовый класс, например .btn
, а затем группируем отдельные стили для каждого варианта в классы-модификаторы, например .btn-primary
или .btn-success
.
Чтобы построить наши классы модификаторов, мы используем @each
циклы Sass для перебора карты Sass. Это особенно полезно для создания вариантов компонента нашими специалистами $theme-colors
и создания адаптивных вариантов для каждой точки останова. Когда вы настроите эти карты Sass и перекомпилируете, вы автоматически увидите, как ваши изменения отражаются в этих циклах.
Ознакомьтесь с документацией по картам и циклам Sass, чтобы узнать, как настроить эти циклы и расширить базовый модификатор Bootstrap на свой собственный код.
Модификаторы
Многие компоненты Bootstrap созданы с использованием подхода базового класса-модификатора. Это означает, что основная часть стилей содержится в базовом классе (например, .btn
), а вариации стиля ограничены классами-модификаторами (например, .btn-danger
). Эти классы-модификаторы создаются из $theme-colors
карты, чтобы настроить количество и имя наших классов-модификаторов.
Вот два примера того, как мы перебираем $theme-colors
карту, чтобы сгенерировать модификаторы для компонентов .alert
и ..list-group
// Generate contextual modifier classes for colorizing the alert.
@each $state, $value in $theme-colors {
$alert-background: shift-color($value, $alert-bg-scale);
$alert-border: shift-color($value, $alert-border-scale);
$alert-color: shift-color($value, $alert-color-scale);
@if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
$alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
}
.alert-#{$state} {
@include alert-variant($alert-background, $alert-border, $alert-color);
}
}
// List group contextual variants
//
// Add modifier classes to change text and background color on individual items.
// Organizationally, this must come after the `:hover` states.
@each $state, $value in $theme-colors {
$list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);
$list-group-variant-color: shift-color($value, $list-group-item-color-scale);
@if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {
$list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));
}
@include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);
}
Отзывчивый
Эти циклы Sass также не ограничиваются картами цветов. Вы также можете создавать адаптивные варианты ваших компонентов. Возьмем, к примеру, наше отзывчивое выравнивание раскрывающихся списков, где мы смешиваем @each
цикл для $grid-breakpoints
карты Sass с включенным медиа-запросом.
// We deliberately hardcode the `bs-` prefix because we check
// this custom property in JS to determine Popper's positioning
@each $breakpoint in map-keys($grid-breakpoints) {
@include media-breakpoint-up($breakpoint) {
$infix: breakpoint-infix($breakpoint, $grid-breakpoints);
.dropdown-menu#{$infix}-start {
--bs-position: start;
&[data-bs-popper] {
right: auto;
left: 0;
}
}
.dropdown-menu#{$infix}-end {
--bs-position: end;
&[data-bs-popper] {
right: 0;
left: auto;
}
}
}
}
Если вы измените свой $grid-breakpoints
, ваши изменения будут применяться ко всем циклам, повторяющимся на этой карте.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
Для получения дополнительной информации и примеров того, как изменить наши карты и переменные Sass, обратитесь к разделу Sass документации по Grid .
Создание собственного
Мы рекомендуем вам принять эти рекомендации при сборке с помощью Bootstrap для создания собственных компонентов. Мы сами расширили этот подход на пользовательские компоненты в нашей документации и примерах. Такие компоненты, как наши выноски, создаются так же, как и предоставленные нами компоненты с базовыми классами и классами-модификаторами.
<div class="callout">...</div>
В вашем CSS у вас будет что-то вроде следующего, где основная часть стилей выполняется с помощью .callout
. Затем уникальные стили между каждым вариантом контролируются с помощью класса модификатора.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
Для выносок этот уникальный стиль — это просто файл border-left-color
. Когда вы объединяете этот базовый класс с одним из этих классов-модификаторов, вы получаете полное семейство компонентов: