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

Компоненты

Узнайте как быстро создавать наши адаптивные компоненты c помощью базовых классов и классов модификаторов.

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

Компоненты 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, $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-background: shift-color($value, $list-group-item-bg-scale);
  $list-group-color: shift-color($value, $list-group-item-color-scale);
  @if (contrast-ratio($list-group-background, $list-group-color) < $min-contrast-ratio) {
    $list-group-color: mix($value, color-contrast($list-group-background), abs($alert-color-scale));
  }

  @include list-group-item-variant($state, $list-group-background, $list-group-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 $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 #{"/* rtl:ignore */"};
        left: 0 #{"/* rtl:ignore */"};
      }
    }

    .dropdown-menu#{$infix}-end {
      --bs-position: end;

      &[data-bs-popper] {
        right: 0 #{"/* rtl:ignore */"};
        left: auto #{"/* rtl:ignore */"};
      }
    }
  }
}

Если вы измените свои $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. Когда вы объединяете этот базовый класс с одним из этих классов-модификаторов, вы получаете полное семейство компонентов:

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