颜色

颜色

Bootstrap 的调色板在 v5.3.0 中持续扩展，变得更加细致。我们为 secondary 和 tertiary 文本和背景颜色添加了新变量，以及 {color}-bg-subtle、{color}-border-subtle 和 {color}-text-emphasis 用于我们的主题颜色。这些新颜色可通过 Sass 和 CSS 变量（但不能通过我们的颜色映射或实用程序类）获得，其明确目标是让在浅色和深色等多种颜色模式下进行自定义变得更加容易。这些新变量在 :root 上全局设置，并针对我们的新深色模式进行了调整，而我们的原始主题颜色保持不变。

以 -rgb 结尾的颜色提供 red, green, blue 值，用于 rgb() 和 rgba() 颜色模式。例如，rgba(var(--bs-secondary-bg-rgb), .5)。

使用新颜色

这些新颜色可通过 CSS 变量和实用程序类（如 --bs-primary-bg-subtle 和 .bg-primary-subtle）访问，使你能够使用这些变量编写自己的 CSS 规则，或通过类快速应用样式。这些实用程序使用与之关联的 CSS 变量构建，并且由于我们为暗模式自定义了这些 CSS 变量，因此它们默认情况下也适用于颜色模式。

<div class="p-3 text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-3">
  Example element with utilities
</div>

主题颜色

我们使用所有颜色的子集来创建较小的颜色调色板，用于生成配色方案，还可以在 Bootstrap 的 scss/_variables.scss 文件中作为 Sass 变量和 Sass 映射获得。

所有这些颜色都可用作 Sass 映射 $theme-colors。

$theme-colors: (
  "primary":    $primary,
  "secondary":  $secondary,
  "success":    $success,
  "info":       $info,
  "warning":    $warning,
  "danger":     $danger,
  "light":      $light,
  "dark":       $dark
);

查看我们的 Sass 映射和循环文档，了解如何修改这些颜色。

所有颜色

所有 Bootstrap 颜色都可用作 Sass 变量和 Sass 映射，位于 scss/_variables.scss 文件中。为了避免文件大小增加，我们不会为每个变量创建文本或背景颜色类。相反，我们从这些颜色中选择一个子集作为 主题调色板。

自定义颜色时，请务必监视对比度。如下所示，我们已向每种主色添加了三种对比度——一种用于色样的当前颜色，一种用于白色，一种用于黑色。

Sass 备注

Sass 无法以编程方式生成变量，因此我们手动为每种色调和阴影创建了变量。我们指定中间值（例如，$blue-500），并使用自定义颜色函数通过 Sass 的 mix() 颜色函数给颜色加深色调（变亮）或加深阴影（变暗）。

使用 mix() 与使用 lighten() 和 darken() 不同——前者将指定颜色与白色或黑色混合，而后者仅调整每种颜色的亮度值。结果是一套更完整的颜色，如 此 CodePen 演示 所示。

我们的 tint-color() 和 shade-color() 函数使用 mix() 以及我们的 $theme-color-interval 变量，该变量为我们生成的每种混合颜色指定一个阶梯式百分比值。请参阅 scss/_functions.scss 和 scss/_variables.scss 文件以获取完整源代码。

颜色 Sass 映射

Bootstrap 的源 Sass 文件包含三个映射，可帮助你快速轻松地循环遍历颜色列表及其十六进制值。

• $colors 列出我们所有可用的基本（500）颜色
• $theme-colors 列出所有语义命名的主题颜色（如下所示）
• $grays 列出了所有灰色的色调和阴影

在 scss/_variables.scss 中，你会找到 Bootstrap 的颜色变量和 Sass 映射。以下是 $colors Sass 映射的一个示例

$colors: (
  "blue":       $blue,
  "indigo":     $indigo,
  "purple":     $purple,
  "pink":       $pink,
  "red":        $red,
  "orange":     $orange,
  "yellow":     $yellow,
  "green":      $green,
  "teal":       $teal,
  "cyan":       $cyan,
  "black":      $black,
  "white":      $white,
  "gray":       $gray-600,
  "gray-dark":  $gray-800
);

在映射中添加、删除或修改值以更新它们在许多其他组件中使用的方式。遗憾的是，目前并非每个组件都使用此 Sass 映射。未来的更新将努力改进这一点。在此之前，计划使用 ${color} 变量和此 Sass 映射。

示例

以下是你如何在 Sass 中使用它们

.alpha { color: $purple; }
.beta {
  color: $yellow-300;
  background-color: $indigo-900;
}

颜色和 背景实用程序类也可用，用于使用 500 颜色值设置 color 和 background-color。

生成实用程序

Bootstrap 并未为每个颜色变量包含 color 和 background-color 实用程序，但你可以使用我们的 实用程序 API 和我们在 v5.1.0 中添加的扩展 Sass 映射自行生成这些实用程序。

1. 首先，确保你已导入我们的函数、变量、混合和实用程序。
2. 使用我们的 map-merge-multiple() 函数快速将多个 Sass 映射合并到一个新映射中。
3. 合并此新的组合映射以使用 {color}-{level} 类名扩展任何实用程序。

以下是一个使用上述步骤生成文本颜色实用程序（例如 .text-purple-500）的示例。

@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";

$all-colors: map-merge-multiple($blues, $indigos, $purples, $pinks, $reds, $oranges, $yellows, $greens, $teals, $cyans);

$utilities: map-merge(
  $utilities,
  (
    "color": map-merge(
      map-get($utilities, "color"),
      (
        values: map-merge(
          map-get(map-get($utilities, "color"), "values"),
          (
            $all-colors
          ),
        ),
      ),
    ),
  )
);

@import "bootstrap/scss/utilities/api";

这将为每种颜色和级别生成新的 .text-{color}-{level} 实用程序。你还可以对任何其他实用程序和属性执行相同操作。