组件

了解我们如何以及为什么使用基和修饰符类以响应方式构建几乎所有组件。

当前页

基类

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组件修饰符的两个示例。

scss/_alert.scss

// Generate contextual modifier classes for colorizing the alert
@each $state in map-keys($theme-colors) {
  .alert-#{$state} {
    --#{$prefix}alert-color: var(--#{$prefix}#{$state}-text-emphasis);
    --#{$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-emphasis);
  }
}

scss/_list-group.scss

// 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-emphasis);
    --#{$prefix}list-group-bg: var(--#{$prefix}#{$state}-bg-subtle);
    --#{$prefix}list-group-border-color: var(--#{$prefix}#{$state}-border-subtle);
    --#{$prefix}list-group-action-hover-color: var(--#{$prefix}emphasis-color);
    --#{$prefix}list-group-action-hover-bg: var(--#{$prefix}#{$state}-border-subtle);
    --#{$prefix}list-group-action-active-color: var(--#{$prefix}emphasis-color);
    --#{$prefix}list-group-action-active-bg: var(--#{$prefix}#{$state}-border-subtle);
    --#{$prefix}list-group-active-color: var(--#{$prefix}#{$state}-bg-subtle);
    --#{$prefix}list-group-active-bg: var(--#{$prefix}#{$state}-text-emphasis);
    --#{$prefix}list-group-active-border-color: var(--#{$prefix}#{$state}-text-emphasis);
  }
}

响应

这些 Sass 循环也不仅限于颜色图。您还可以生成组件的响应变体。以我们对下拉列表的响应式对齐为例，我们将$grid-breakpointsSass 映射的@each循环与媒体查询包含混合在一起。

scss/_dropdown.scss

// 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，则更改将应用于遍历该映射的所有循环。

scss/_variables.scss

$grid-breakpoints: (
  xs: 0,
  sm: 576px,
  md: 768px,
  lg: 992px,
  xl: 1200px,
  xxl: 1400px
);

有关如何修改 Sass 映射和变量的更多信息和示例，请参阅网格文档的 Sass 部分。

创建您自己的

我们鼓励您在使用 Bootstrap 进行构建以创建自己的组件时采用这些准则。我们已将此方法扩展到文档和示例中的自定义组件。像我们的标注这样的组件就像我们提供的带有基类和修饰符类的组件一样构建。

This is a callout. We built it custom for our docs so our messages to you stand out. It has three variants via modifier classes.

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

在你的CSS中，你会有类似以下内容的东西，其中大部分样式是通过.callout完成的。然后，通过修饰符类控制每个变体之间的唯一样式。

// Base class
.callout {}

// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}

对于标注，这种独特的样式只是 border-left-color。将该基类与其中一个修饰符类组合在一起时，您将获得完整的组件系列：

这是一个信息标注。 用于显示其操作的示例文本。

这是一个警告标注。 用于显示其操作的示例文本。

这是一个危险的标注。 用于显示其操作的示例文本。

组件

基类

修饰 符

响应

创建您自己的

修饰符