跳到主要内容 跳到文档导航
Check
in English

CSS 变量

使用 Bootstrap 的 CSS 自定义属性进行快速和前瞻性的设计和开发。

在本页面

Bootstrap 在其编译后的 CSS 中包含许多CSS 自定义属性(变量),用于实时自定义,无需重新编译 Sass。当在浏览器的检查器、代码沙箱或一般原型设计中工作时,这些提供了对常用值的轻松访问,例如我们的主题颜色、断点和主要字体堆栈。

我们所有的自定义属性都带有前缀,bs-以避免与第三方 CSS 冲突。

根变量

以下是我们包含的变量(请注意,这:root是必需的),可以在加载 Bootstrap 的 CSS 的任何地方访问。它们位于我们的_root.scss文件中,并包含在我们编译的 dist 文件中。

:root {
  --bs-blue: #0d6efd;
  --bs-indigo: #6610f2;
  --bs-purple: #6f42c1;
  --bs-pink: #d63384;
  --bs-red: #dc3545;
  --bs-orange: #fd7e14;
  --bs-yellow: #ffc107;
  --bs-green: #198754;
  --bs-teal: #20c997;
  --bs-cyan: #0dcaf0;
  --bs-black: #000;
  --bs-white: #fff;
  --bs-gray: #6c757d;
  --bs-gray-dark: #343a40;
  --bs-gray-100: #f8f9fa;
  --bs-gray-200: #e9ecef;
  --bs-gray-300: #dee2e6;
  --bs-gray-400: #ced4da;
  --bs-gray-500: #adb5bd;
  --bs-gray-600: #6c757d;
  --bs-gray-700: #495057;
  --bs-gray-800: #343a40;
  --bs-gray-900: #212529;
  --bs-primary: #0d6efd;
  --bs-secondary: #6c757d;
  --bs-success: #198754;
  --bs-info: #0dcaf0;
  --bs-warning: #ffc107;
  --bs-danger: #dc3545;
  --bs-light: #f8f9fa;
  --bs-dark: #212529;
  --bs-primary-rgb: 13, 110, 253;
  --bs-secondary-rgb: 108, 117, 125;
  --bs-success-rgb: 25, 135, 84;
  --bs-info-rgb: 13, 202, 240;
  --bs-warning-rgb: 255, 193, 7;
  --bs-danger-rgb: 220, 53, 69;
  --bs-light-rgb: 248, 249, 250;
  --bs-dark-rgb: 33, 37, 41;
  --bs-white-rgb: 255, 255, 255;
  --bs-black-rgb: 0, 0, 0;
  --bs-body-color-rgb: 33, 37, 41;
  --bs-body-bg-rgb: 255, 255, 255;
  --bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));
  --bs-body-font-family: var(--bs-font-sans-serif);
  --bs-body-font-size: 1rem;
  --bs-body-font-weight: 400;
  --bs-body-line-height: 1.5;
  --bs-body-color: #212529;
  --bs-body-bg: #fff;
  --bs-border-width: 1px;
  --bs-border-style: solid;
  --bs-border-color: #dee2e6;
  --bs-border-color-translucent: rgba(0, 0, 0, 0.175);
  --bs-border-radius: 0.375rem;
  --bs-border-radius-sm: 0.25rem;
  --bs-border-radius-lg: 0.5rem;
  --bs-border-radius-xl: 1rem;
  --bs-border-radius-2xl: 2rem;
  --bs-border-radius-pill: 50rem;
  --bs-link-color: #0d6efd;
  --bs-link-hover-color: #0a58ca;
  --bs-code-color: #d63384;
  --bs-highlight-bg: #fff3cd;
}

组件变量

Bootstrap 5 越来越多地使用自定义属性作为各种组件的局部变量。通过这种方式,我们减少了编译的 CSS,确保样式不会在嵌套表等地方继承,并允许在 Sass 编译后对 Bootstrap 组件进行一些基本的重新设置和扩展。

查看我们的表格文档,了解我们如何使用 CSS 变量。从 v5.2.0 开始,我们的导航栏也使用 CSS 变量。我们还在我们的网格中使用 CSS 变量——主要是为了装订新的可选 CSS 网格——未来会有更多的组件使用。

只要有可能,我们将在基本组件级别分配 CSS 变量(例如,.navbar导航栏及其子组件)。这减少了对自定义位置和方式的猜测,并允许我们的团队在未来的更新中轻松修改。

字首

大多数 CSS 变量使用前缀来避免与您自己的代码库发生冲突。此前缀是--每个 CSS 变量所需的前缀。

$prefix通过Sass 变量自定义前缀。默认情况下,它设置为bs-(注意尾随破折号)。

例子

CSS 变量提供了与 Sass 的变量类似的灵活性,但在提供给浏览器之前不需要编译。例如,这里我们使用 CSS 变量重置页面的字体和链接样式。

body {
  font: 1rem/1.5 var(--bs-font-sans-serif);
}
a {
  color: var(--bs-blue);
}

网格断点

虽然我们将网格断点包含为 CSS 变量(除了xs),但请注意CSS 变量在媒体查询中不起作用。这是 CSS 规范中针对变量的设计,但未来几年可能会随着对env()变量的支持而改变。查看这个 Stack Overflow 答案以获得一些有用的链接。同时,您可以在其他 CSS 情况以及 JavaScript 中使用这些变量。