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

Компоненты

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

Содержание

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

Компоненты 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 $color, $value in $theme-colors { 
  .alert-#{ $color} { 
    @include alert-variant(color-level($value, $alert-bg-level), color-level($value, $alert-border-level), color-level($value, $alert-color-level));
  }
}
// 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 $color, $value in $theme-colors { 
  @include list-group-item-variant($color, color-level($value, $list-group-item-bg-level), color-level($value, $list-group-item-color-level));
}

Отзывчивость

Эти циклы Sass также не ограничиваются цветовыми картами. Вы также можете создавать адаптивные варианты ваших компонентов. Возьмем, к примеру, наше адаптивное выравнивание раскрывающихся списков, где мы смешиваем @each цикл для $grid-breakpoints карты Sass с включением медиа-запроса.

@each $breakpoint in map-keys($grid-breakpoints) { 
  @include media-breakpoint-up($breakpoint) { 
    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);

    .dropdown-menu#{ $infix}-left { 
      right: auto;
      left: 0;
    }

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

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