Компоненты

Базовые классы

Компоненты Bootstrap в основном построены с номенклатурой модификатора базы. Мы группируем как можно больше общих свойств в базовый класс, например .btn, а затем группируем отдельные стили для каждого варианта в классы модификаторов, например .btn-primary или .btn-success.

Для создания наших классов-модификаторов мы используем Sass циклы @each для итерации по 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,$valuein$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,$valuein$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 для карты Sass $grid-breakpoints с включением медиа-запроса.

// We deliberately hardcode the `bs-` prefix because we check
// this custom property in JS to determine Popper's positioning
@each$breakpointinmap-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 документации по Сетке.

Создание собственного

Мы рекомендуем Вам следовать этим рекомендациям при сборке с помощью Bootstrap, чтобы создавать свои собственные компоненты. Мы сами распространили этот подход на пользовательские компоненты в нашей документации и примерах. Компоненты, подобные нашим сноскам, создаются так же, как предоставленные нами компоненты с базовыми классами и модификаторами.

<divclass="callout">...</div>

В Вашем CSS у Вас будет что-то вроде следующего, где основная часть стиля выполняется через .callout. Затем уникальные стили между каждым вариантом контролируются с помощью класса модификатора.

// Базовый класс
.callout{}// Классы модификаторов
.callout-info{}.callout-warning{}.callout-danger{}

Для сноски этот уникальный стиль представляет собой просто border-left-color. Когда Вы объединяете этот базовый класс с одним из этих классов-модификаторов, Вы получаете полное семейство компонентов: