Skip to main content Skip to docs navigation

颜色

Bootstrap 由广泛的颜色系统支持,样式和组件的主题。 这可以为任何项目实现更全面的定制和扩展。

主题颜色

我们使用所有颜色的子集来创建一个较小的调色板来生成配色方案,也可以供 scss/_variables.scss 文件中 Sass 变量和的 Sass 映射使用。

Primary
Secondary
Success
Danger
Warning
Info
Light
Dark

所有这些颜色都可以作为 Sass 映射使用,$theme-colors

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

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

所有颜色

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

在自定义颜色时,请务必监控对比度。 如下所示,我们为每种主要颜色添加了三种对比度——一种用于色板的当前颜色,一种用于针对白色,一种用于针对黑色。

$blue #0d6efd
$blue-100
$blue-200
$blue-300
$blue-400
$blue-500
$blue-600
$blue-700
$blue-800
$blue-900
$indigo #6610f2
$indigo-100
$indigo-200
$indigo-300
$indigo-400
$indigo-500
$indigo-600
$indigo-700
$indigo-800
$indigo-900
$purple #6f42c1
$purple-100
$purple-200
$purple-300
$purple-400
$purple-500
$purple-600
$purple-700
$purple-800
$purple-900
$pink #d63384
$pink-100
$pink-200
$pink-300
$pink-400
$pink-500
$pink-600
$pink-700
$pink-800
$pink-900
$red #dc3545
$red-100
$red-200
$red-300
$red-400
$red-500
$red-600
$red-700
$red-800
$red-900
$orange #fd7e14
$orange-100
$orange-200
$orange-300
$orange-400
$orange-500
$orange-600
$orange-700
$orange-800
$orange-900
$yellow #ffc107
$yellow-100
$yellow-200
$yellow-300
$yellow-400
$yellow-500
$yellow-600
$yellow-700
$yellow-800
$yellow-900
$green #198754
$green-100
$green-200
$green-300
$green-400
$green-500
$green-600
$green-700
$green-800
$green-900
$teal #20c997
$teal-100
$teal-200
$teal-300
$teal-400
$teal-500
$teal-600
$teal-700
$teal-800
$teal-900
$cyan #0dcaf0
$cyan-100
$cyan-200
$cyan-300
$cyan-400
$cyan-500
$cyan-600
$cyan-700
$cyan-800
$cyan-900
$gray-500 #adb5bd
$gray-100
$gray-200
$gray-300
$gray-400
$gray-500
$gray-600
$gray-700
$gray-800
$gray-900
$black #000
$white #fff

Sass 注释

Sass 无法以编程方式生成变量,因此我们自己手动为每种着色和阴影创建变量。 我们指定中点值(例如,$blue-500)并使用自定义颜色函数,通过 Sass 的 mix() 颜色功能,获得我们的颜色——着色(变亮)或阴影(变暗)。

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

我们的 tint-color()shade-color() 函数使用 mix() 和我们的 $theme-color-interval 变量,它为我们产生的每种混合颜色指定一个阶梯百分比值。 有关完整源代码,请参阅 scss/_functions.scssscss/_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,
  "white":      $white,
  "gray":       $gray-600,
  "gray-dark":  $gray-800
);

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

示例

以下是在 Sass 中使用它们的方法:

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

Colorbackground 实用程序类也可用于设置 colorbackground-color 使用 500 颜色值。

生成实用程序

在v5.1.0时添加

Bootstrap 不包含每个颜色变量的 colorbackground-color 实用程序,但您可以使用我们的 实用程序 API 和我们在 v5.1.0 中添加的扩展 Sass 映射。

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

这是一个使用上述步骤生成文本颜色实用程序(例如,.text-purple-500)的示例。

@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@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} 实用程序。 您也可以对任何其他实用程序和资源执行相同的操作。