组件定制

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

本页目录

基础类

Bootstrap 的组件大多使用基础-修饰符命名法构建。我们将尽可能多的共享属性归入基础类，如 .btn，然后将每个变体的单独样式归入修饰符类，如 .btn-primary 或 .btn-success。

要构建我们的修饰符类，我们使用 Sass 的 @each 循环来迭代 Sass 映射。这对于根据我们的 $theme-colors 生成组件的变体以及为每个断点创建响应式变体尤其有用。当你自定义这些 Sass 映射并重新编译时，你会自动在这些循环中看到你的更改。

查看我们的 Sass Map 和循环文档，了解如何自定义这些循环，并将 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 循环也不限于颜色映射。你还可以生成组件的响应式变体。例如我们对下拉菜单的响应式对齐，其中我们将 @each 循环与 $grid-breakpoints Sass 映射以及媒体查询包含混合使用。

scss/_下拉菜单.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);
<span class="token selector">.dropdown-menu<span class="token variable">#{$infix}</span>-start </span><span class="token punctuation">{</span>
  <span class="token property">--bs-position</span><span class="token punctuation">:</span> start<span class="token punctuation">;</span>

  <span class="token selector"><span class="token parent important">&amp;</span>[data-bs-popper] </span><span class="token punctuation">{</span>
    <span class="token property">right</span><span class="token punctuation">:</span> auto<span class="token punctuation">;</span>
    <span class="token property">left</span><span class="token punctuation">:</span> 0<span class="token punctuation">;</span>
  <span class="token punctuation">}</span>
<span class="token punctuation">}</span>

<span class="token selector">.dropdown-menu<span class="token variable">#{$infix}</span>-end </span><span class="token punctuation">{</span>
  <span class="token property">--bs-position</span><span class="token punctuation">:</span> end<span class="token punctuation">;</span>

  <span class="token selector"><span class="token parent important">&amp;</span>[data-bs-popper] </span><span class="token punctuation">{</span>
    <span class="token property">right</span><span class="token punctuation">:</span> 0<span class="token punctuation">;</span>
    <span class="token property">left</span><span class="token punctuation">:</span> auto<span class="token punctuation">;</span>
  <span class="token punctuation">}</span>
<span class="token punctuation">}</span>
}
}

如果你修改你的 $grid-breakpoints，你的更改将应用于所有迭代该映射的循环。

scss/_variables.scss

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

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

创建你自己的

我们鼓励你在使用 Bootstrap 构建时采用这些指南，以创建你自己的组件。我们自己也将这种方法扩展到文档和示例中的自定义组件中。像我们的提示框这样的组件的构建方式与我们提供的组件相同，都使用基础类和修饰类。

这是一个提示框。 我们为文档自定义了它，以便我们的信息能够突出显示。它通过修饰类有三种变体。

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

在你的 CSS 中，你可能会有如下内容，其中大部分样式是通过 .callout 完成的。然后，每个变体之间的独特样式是通过修饰类来控制的。

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

对于呼叫框，那种独特的样式只是一个 border-left-color。当你将该基础类与其中一个修饰类组合时，你就得到完整的组件家族：

这是一个信息提示。 示例文本用于展示其效果。

这是一个警告提示。 示例文本以显示其效果。

这是一个危险提示。 示例文本用于展示其效果。