主题 | Theming Bootstrap

主题引导

自定义引导4与我们的新内置Sass变量，为全球风格的首选项，以便于主题和组件的变化。

导言

在Bootstrap 3中，主题化很大程度上是由更少的、自定义的css中的变量重写驱动的，以及我们在我们的dist档案。通过一些努力，我们可以完全重新设计Bootstrap 3的外观，而无需触及核心文件。引导4提供了一种熟悉但略有不同的方法。

现在，主题化由Sass变量、Sass映射和自定义CSS完成。不再有专门的主题样式表；相反，您可以启用内置主题来添加渐变、阴影等。

沙斯

利用我们的源代码Sass文件来利用变量、映射、混合体等等。

文件结构

尽可能避免修改Bootstrap的核心文件。对于Sass来说，这意味着创建您自己的样式表来导入引导程序，以便您可以修改和扩展它。假设您已经下载了源文件或正在使用包管理器，那么您的文件结构如下所示：

your-project/
├── scss
│   └── custom.scss
└── node_modules/
    └── bootstrap
        ├── js
        └── scss

在你的custom.scss，您将导入Bootstrap的源Sass文件。你有两个选择：包括所有的引导，或选择你需要的部分。我们鼓励后者，但要注意，组件之间存在一些需求和依赖关系。您还需要为我们的插件添加一些JavaScript。

// Custom.scss
// Option A: Include all of Bootstrap

@import "node_modules/bootstrap/scss/bootstrap";

// Custom.scss
// Option B: Include parts of Bootstrap

// Required
@import "node_modules/bootstrap/scss/functions";
@import "node_modules/bootstrap/scss/variables";
@import "node_modules/bootstrap/scss/mixins";

// Optional
@import "node_modules/bootstrap/scss/reboot";
@import "node_modules/bootstrap/scss/type";
@import "node_modules/bootstrap/scss/images";
@import "node_modules/bootstrap/scss/code";
@import "node_modules/bootstrap/scss/grid";

设置就绪后，您可以开始修改custom.scss.还可以开始在// Optional根据需要分部门。

变量默认值

引导程序4中的每个Sass变量包括!default标志允许您在自己的Sass中重写变量的默认值，而无需修改Bootstrap的源代码。根据需要复制和粘贴变量，修改它们的值，并删除!default旗子。如果一个变量已经被赋值，那么它将不会被重新赋值的默认值在引导。

变量可以在默认变量之前或之后重写同一Sass文件。但是，在重写Sass文件时，您的重写必须在导入引导程序的Sass文件之前进行。

下面是一个更改background-color和color为<body>在通过国家预防机制导入和编译Bootstrap时：

// Your variable overrides
$body-bg: #000;
$body-color: #111;

// Bootstrap and its default variables
@import "node_modules/bootstrap/scss/bootstrap";

根据需要，对Bootstrap中的任何变量重复，包括下面的全局选项。

映射和循环

引导4包含了少量的Sass映射，键值对使得生成相关CSS的家族变得更容易。我们使用Sass地图作为我们的颜色，网格断点，等等。就像Sass变量一样，所有Sass映射都包括!default标志，可以重写和扩展。

例如，要修改$theme-colors映射，将以下内容添加到您的自定义Sass文件中：

$theme-colors: (
  "primary": #0074d9,
  "danger": #ff4136

若要将新颜色添加到$theme-colors，添加新的键和值：

$theme-colors: (
  "custom-color": #900

功能

引导程序使用了几个Sass函数，但只有一个子集适用于一般主题化。我们包含了三个从颜色地图中获取值的函数：

@function color($key: "blue") {
  @return map-get($colors, $key
}

@function theme-color($key: "primary") {
  @return map-get($theme-colors, $key
}

@function gray($key: "100") {
  @return map-get($grays, $key
}

这些允许您从Sass地图中选择一种颜色，就像使用v3中的颜色变量一样。

.custom-element {
  color: gray("100"
  background-color: theme-color("dark"
}

我们还有另一个功能来获得一个特定的水平的颜色$theme-colors地图。负的等级值会使颜色变浅，而较高的值则会变暗。

@function theme-color-level($color-name: "primary", $level: 0) {
  $color: theme-color($color-name
  $color-base: if($level > 0, #000, #fff
  $level: abs($level

  @return mix($color-base, $color, $level * $theme-color-interval
}

实际上，您可以调用该函数并传入两个参数：$theme-colors%28E.。g.，主要或危险%29和数字级别。

.custom-element {
  color: theme-color-level(primary, -10
}

将来还可以添加其他函数，或者添加您自己的自定义Sass，以便为其他Sass映射创建级别函数，如果您想要更详细，甚至可以添加一个通用函数。

色彩对比

我们在Bootstrap中包含的一个附加功能是颜色对比功能，color-yiq.它利用YIQ颜色空间自动返回光%28#fff%29或黑暗%28#111%29基于指定基色的对比度颜色。此函数对于生成多个类的混和或循环特别有用。

例如，要从我们的$theme-colors地图：

@each $color, $value in $theme-colors {
  .swatch-#{$color} {
    color: color-yiq($value
  }
}

它也可用于一次性对比需要：

.custom-element {
  color: color-yiq(#000 // returns `color: #fff`
}

还可以使用颜色映射函数指定基色：

.custom-element {
  color: color-yiq(theme-color("dark") // returns `color: #fff`
}

SASS选项

使用内置的自定义变量文件自定义引导程序4，并轻松切换新的全局css首选项。$enable-*一些变量。重写变量的值并用npm run test视需要而定。

您可以在_variables.scss档案。

Variable	Values	Description
$spacer	1rem (default), or any value > 0	Specifies the default spacer value to programmatically generate our spacer utilities.
$enable-rounded	true (default) or false	Enables predefined border-radius styles on various components.
$enable-shadows	true or false (default)	Enables predefined box-shadow styles on various components.
$enable-gradients	true or false (default)	Enables predefined gradients via background-image styles on various components.
$enable-transitions	true (default) or false	Enables predefined transitions on various components.
$enable-hover-media-query	true or false (default)	…
$enable-grid-classes	true (default) or false	Enables the generation of CSS classes for the grid system (e.g., .container, .row, .col-md-1, etc.).
$enable-caret	true (default) or false	Enables pseudo element caret on .dropdown-toggle.
$enable-print-styles	true (default) or false	Enables styles for optimizing printing.

颜色

Bootstrap的许多组件和实用程序都是通过Sass映射中定义的一系列颜色构建的。这个映射可以在Sass中循环以快速生成一系列规则集。

所有颜色

Bootstrap 4中提供的所有颜色都可以作为Sass变量和我们的Sass映射提供。scss/_variables.scss档案。这将在随后的小版本中扩展，以添加更多的阴影，类似于灰度调色板我们已经包括了。

蓝色

靛蓝

紫

粉红

红

橙色

黄

绿

提尔

青色

下面是如何在Sass中使用这些内容：

// With variable
.alpha { color: $purple; }

// From the Sass map with our `color()` function
.beta { color: color("purple" }

颜色工具类也可用于设置color和background-color。

在未来，我们的目标是为每种颜色的阴影提供Sass地图和变量，就像我们对下面的灰度颜色所做的那样。

主题色彩

我们使用所有颜色的子集来创建一个较小的调色板，用于生成配色方案，也可以作为Sass变量和我们的Sass映射使用。scss/_variables.scss档案。

初等

二次

成功

危险

警告

信息

轻光

黑暗

格雷斯

的灰色变量集和Sass映射scss/_variables.scss在整个项目中保持一致的灰色阴影。

100

200

300

400

500

600

700

800

900

内_variables.scss，你会找到我们的颜色变量和Sass地图。下面是一个例子$colorsSass地图：

$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
) !default;

在映射中添加、删除或修改值，以更新它们在许多其他组件中的使用方式。不幸的是，在这个时候，每一个组件使用此Sass映射。今后的更新将努力改进这一点。在此之前，计划利用${color}变量和这个Sass地图。

组件

Bootstrap的许多组件和实用程序都是用@each在Sass映射上迭代的循环。这对于我们生成组件的变体尤其有帮助。$theme-colors并为每个断点创建响应变量。当您自定义这些Sass映射并重新编译时，您将自动看到这些循环中反映的更改。

修饰符

许多Bootstrap组件都是使用基础修饰符类的方法构建的。这意味着大部分样式都包含在基类中（例如.btn），而样式变体仅限于修饰符类（例如，.btn-danger）。这些修饰符类是从$theme-colors地图构建的，以定制我们修饰符类的数量和名称。

下面是我们如何遍历$theme-colors生成修饰符的映射。.alert组件和我们所有的.bg-*背景实用程序。

// Generate alert modifier classes
@each $color, $value in $theme-colors {
  .alert-#{$color} {
    @include alert-variant(theme-color-level($color, -10), theme-color-level($color, -9), theme-color-level($color, 6)
  }
}

// Generate `.bg-*` color utilities
@each $color, $value in $theme-colors {
  @include bg-variant('.bg-#{$color}', $value
}

响应性

这些Sass循环也不限于彩色地图。您还可以生成组件或实用程序的响应变体。例如，我们的响应性文本对齐实用程序将@each循环的$grid-breakpoints包含媒体查询的Sass地图。

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

    .text#{$infix}-left   { text-align: left !important; }
    .text#{$infix}-right  { text-align: right !important; }
    .text#{$infix}-center { text-align: center !important; }
  }
}

如果您需要修改$grid-breakpoints，您的更改将应用于遍历该映射的所有循环。