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

Компоненты

Узнайте, как и почему мы создаем почти все наши компоненты адаптивно, используя базовые классы и классы-модификаторы.

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

Компоненты 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 in map-keys($theme-colors) {
  .alert-#{$state} {
    --#{$prefix}alert-color: var(--#{$prefix}#{$state}-text);
    --#{$prefix}alert-bg: var(--#{$prefix}#{$state}-bg-subtle);
    --#{$prefix}alert-border-color: var(--#{$prefix}#{$state}-border-subtle);
    --#{$prefix}alert-link-color: var(--#{$prefix}#{$state}-text);
  }
}
// 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 in map-keys($theme-colors) {
  .list-group-item-#{$state} {
    --#{$prefix}list-group-color: var(--#{$prefix}#{$state}-text);
    --#{$prefix}list-group-bg: var(--#{$prefix}#{$state}-bg-subtle);
    --#{$prefix}list-group-border-color: var(--#{$prefix}#{$state}-border-subtle);

    &.list-group-item-action {
      &:hover,
      &:focus {
        --#{$prefix}list-group-action-hover-color: var(--#{$prefix}emphasis-color);
        --#{$prefix}list-group-action-hover-bg: var(--#{$prefix}#{$state}-border-subtle);
      }

      &:active {
        --#{$prefix}list-group-active-color: var(--#{$prefix}emphasis-color);
        --#{$prefix}list-group-active-bg: var(--#{$prefix}#{$state}-text);
        --#{$prefix}list-group-active-border-color: var(--#{$prefix}#{$state}-text);
      }
    }
  }
}

Адаптивность

Эти циклы 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 $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 документации по Сетке.

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

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

Это сноска. Мы создали его специально для наших документов, чтобы наши сообщения вам выделялись. Он имеет три варианта через классы модификаторов.
<div class="callout">...</div>

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

// Базовый класс
.callout {}

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

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

Это информационное сообщение. Пример текста, чтобы показать это в действии.
Это предупреждение. Пример текста, чтобы показать это в действии.
Это предупреждение об опасности. Пример текста, чтобы показать это в действии.