Bootstrap V5.3 中文手册

Bootstrap V5.3 中文手册

Bootstrap V5.3中文手册_中文翻译版

启动

使用 Bootstrap 构建快速响应的网站

功能强大、可扩展且功能丰富的前端工具包。使用 Sass 构建和定制,利用预构建的网格系统和组件,并使用强大的 JavaScript 插件使项目栩栩如生。

npm i bootstrap@5.3.8

当前 v5.3.8

以您想要的方式开始

直接使用 Bootstrap 进行构建 – 使用 CDN,通过包管理器安装它,或下载源代码。

阅读安装文档

通过包管理器安装

通过 npm、RubyGems、Composer 或 Meteor 安装 Bootstrap 的源 Sass 和 JavaScript 文件。包管理安装不包括文档或我们的完整构建脚本。您还可以使用我们的示例存储库中的任何演示来快速启动 Bootstrap 项目。

npm install bootstrap@5.3.8
gem install bootstrap -v 5.3.8

阅读我们的安装文档以获取更多信息和其他包管理器。

通过 CDN 包含

当你只需要包含 Bootstrap 的编译 CSS 或 JS 时,你可以使用 jsDelivr。通过我们简单的快速入门查看它的实际效果,或浏览示例以快速启动您的下一个项目。您还可以选择分别包含 Popper 和我们的 JS。

<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB" crossorigin="anonymous">
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.bundle.min.js" integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI" crossorigin="anonymous"></script>

阅读我们的入门指南

通过我们的官方指南,开始将 Bootstrap 的源文件包含在新项目中。

使用 Sass 自定义一切

Bootstrap 利用 Sass 实现模块化和可定制的架构。仅导入您需要的组件,启用渐变和阴影等全局选项,并使用我们的变量、映射、函数和混合编写您自己的 CSS。

了解有关自定义的更多信息

包括 Bootstrap 的所有 Sass

导入一个样式表,您就可以开始使用我们 CSS 的每一个功能进行比赛了。

// Variable overrides first
$primary: #900;
$enable-shadows: true;
$prefix: "mo-";

// Then import Bootstrap
@import "../node_modules/bootstrap/scss/bootstrap";

了解有关我们的全球 Sass 选项的更多信息。

包括您需要的内容

自定义 Bootstrap 的最简单方法——仅包含您需要的 CSS。

// Functions first
@import "../node_modules/bootstrap/scss/functions";

// Variable overrides second
$primary: #900;
$enable-shadows: true;
$prefix: "mo-";

// Required Bootstrap imports
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/variables-dark";
@import "../node_modules/bootstrap/scss/maps";
@import "../node_modules/bootstrap/scss/mixins";
@import "../node_modules/bootstrap/scss/root";

// Optional components
@import "../node_modules/bootstrap/scss/utilities";
@import "../node_modules/bootstrap/scss/reboot";
@import "../node_modules/bootstrap/scss/containers";
@import "../node_modules/bootstrap/scss/grid";
@import "../node_modules/bootstrap/scss/helpers";
@import "../node_modules/bootstrap/scss/utilities/api";

了解有关将 Bootstrap 与 Sass 一起使用的更多信息。

使用 CSS 变量实时构建和扩展

Bootstrap 5 随着每个版本的发布而不断发展,以更好地利用 CSS 变量来实现全局主题样式,单独 组件,甚至实用程序。我们提供了数十种颜色、字体样式等变量,可在任何地方使用。在组件和实用程序上,CSS 变量的作用域限定为相关类,并且可以轻松 被修改。:root

了解有关 CSS 变量的更多信息

使用 CSS 变量

使用我们的任何全局 :root 变量来编写新样式。CSS 变量使用语法,可以由子级继承 元素。var(--bs-variableName)

.component {
  color: var(--bs-gray-800);
  background-color: var(--bs-gray-100);
  border: 1px solid var(--bs-gray-200);
  border-radius: .25rem;
}

.component-header {
  color: var(--bs-purple);
}

通过 CSS 变量进行自定义

覆盖全局变量、组件类或实用程序类变量,以根据需要自定义 Bootstrap。无需 重新声明每个规则,只是一个新的变量值。

body {
  --bs-body-font-family: var(--bs-font-monospace);
  --bs-body-line-height: 1.4;
  --bs-body-bg: var(--bs-gray-100);
}

.table {
  --bs-table-color: var(--bs-gray-600);
  --bs-table-bg: var(--bs-gray-100);
  --bs-table-border-color: transparent;
}

组件,满足实用程序 API

Bootstrap 5 中的新功能是,我们的实用程序现在由我们的实用程序 API 生成。我们将其构建为功能丰富的 Sass 地图,可以快速轻松地进行自定义。从未如此简单 添加、删除或修改任何实用程序类。使实用程序响应,添加伪类变体,并给它们 自定义名称。

快速定制组件

将我们包含的任何实用程序类应用于我们的组件以自定义它们的外观,例如导航 下面的示例。有数百种可用类别——从定位和大小到颜色和效果。将它们与 CSS 变量覆盖混合使用 更多的控制。

<ul class="nav nav-pills nav-fill gap-2 p-1 small bg-primary rounded-5 shadow-sm" id="pillNav2" role="tablist" style="--bs-nav-link-color: var(--bs-white); --bs-nav-pills-link-active-color: var(--bs-primary); --bs-nav-pills-link-active-bg: var(--bs-white);">
  <li class="nav-item" role="presentation">
    <button class="nav-link active rounded-5" id="home-tab2" data-bs-toggle="tab" type="button" role="tab" aria-selected="true">Home</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link rounded-5" id="profile-tab2" data-bs-toggle="tab" type="button" role="tab" aria-selected="false">Profile</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link rounded-5" id="contact-tab2" data-bs-toggle="tab" type="button" role="tab" aria-selected="false">Contact</button>
  </li>
</ul>

探索定制组件

创建和扩展实用程序

使用 Bootstrap 的实用程序 API 修改我们包含的任何实用程序或为任何创建您自己的自定义实用程序 项目。先导入 Bootstrap,然后使用 Sass 映射函数修改、添加或删除实用程序。

@import "bootstrap/scss/bootstrap";

$utilities: map-merge(
  $utilities,
  (
    "cursor": (
      property: cursor,
      class: cursor,
      responsive: true,
      values: auto pointer grab,
    )
  )
);

探索实用程序 API

强大的 JavaScript 插件,无需 jQuery

添加可切换的隐藏元素、模式和画布外菜单、弹出框和工具提示等等——所有这些都无需 jQuery 的。Bootstrap 的 JavaScript 是 HTML 优先的,这意味着大多数插件都是在 HTML 的 HTML 中。需要更多控制?以编程方式包含单个插件。data

了解有关 Bootstrap JavaScript 的更多信息

数据属性 API

当你可以写 HTML 时,为什么还要写更多的 JavaScript?几乎所有 Bootstrap 的 JavaScript 插件都具有 一流的数据 API,让您只需添加属性即可使用 JavaScript。data

<div class="dropdown">
  <button class="btn btn-primary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
    Dropdown
  </button>
  <ul class="dropdown-menu">
    <li><button class="dropdown-item" type="button">Dropdown item</button></li>
    <li><button class="dropdown-item" type="button">Dropdown item</button></li>
    <li><button class="dropdown-item" type="button">Dropdown item</button></li>
  </ul>
</div>

详细了解我们的 JavaScript 作为模块和使用编程 API。

全面的插件集

Bootstrap 具有十几个插件,您可以将它们放入任何项目中。将它们一次性全部放入,或仅选择 你需要的那些。


警报

向用户显示和隐藏警报消息。

按钮

以编程方式控制按钮的活动状态。

旋转 木马

将幻灯片添加到任何页面,包括对交叉淡入淡出的支持。

崩溃

展开和折叠内容区域,或创建手风琴。

下拉菜单

创建链接、作、表单等菜单。

模 态

为您的项目添加灵活且响应迅速的对话框。

画布外

构建隐藏的侧边栏并将其切换到任何页面中。

弹出窗口

创建自定义叠加层。基于 Popper 构建。

卷轴间谍

根据页面滚动自动更新活动导航链接。

标签

允许 Bootstrap 导航组件切换内容。

吐司

向访客显示和隐藏通知。

工具提示

将浏览器工具提示替换为自定义工具提示。基于 Popper 构建。

使用 Bootstrap 图标对其进行个性化设置

Bootstrap Icons 是一个开源 SVG 图标库,具有 1,800 多个字形,具有 每个版本都添加了更多内容。它们旨在用于任何项目,无论您是否使用 Bootstrap 本身。使用它们 作为 SVG 或图标字体——这两个选项都为您提供矢量缩放和通过 CSS 轻松自定义。

获取 Bootstrap 图标

Bootstrap Icons