以下是关于 Bootstrap 5 进度条(Progress Bars) 的详细指南,包含目录、内部锚链接、出站链接和参考资料。我将从基本概念、使用方法到高级功能逐一讲解,帮助您快速掌握 Progress Bars 的使用。


Bootstrap 5 进度条(Progress Bars)指南

目录

  1. 什么是 Progress Bars
  2. 基本使用
  1. 高级用法
  1. 注意事项
  2. 参考资料

什么是 Progress Bars

Progress Bars 是 Bootstrap 5 提供的一种组件,用于显示任务或操作的进度。它通过直观的条形图表示完成百分比,常用于文件上传、表单提交或加载状态展示。

出站链接:查看 Bootstrap 5 Progress Bars 官方文档


基本使用

HTML 结构

Progress Bars 使用 .progress 类定义容器,.progress-bar 表示填充部分。

基本示例

以下是一个简单的进度条示例:

<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
  • .progress:进度条容器。
  • .progress-bar:填充部分。
  • style="width: ...":设置进度百分比。
  • aria-*:提升可访问性。

高级用法

自定义进度

通过调整 width 属性设置不同的进度值。

示例代码:

<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 50%;" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
</div>

自定义颜色

使用 .bg-* 类调整进度条颜色。

示例代码:

<div class="progress">
  <div class="progress-bar bg-success" role="progressbar" style="width: 75%;" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar bg-danger" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
  • .bg-success.bg-danger:应用预定义颜色。

自定义高度

通过 CSS 调整 .progress 的高度。

示例代码:

<div class="progress" style="height: 20px;">
  <div class="progress-bar" role="progressbar" style="width: 60%;" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100"></div>
</div>
  • height:设置进度条高度。

带标签

在进度条内显示百分比或自定义文本。

示例代码:

<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 40%;" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100">40%</div>
</div>

多条进度条

通过堆叠多个 .progress-bar 显示多个进度。

示例代码:

<div class="progress">
  <div class="progress-bar bg-success" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
  <div class="progress-bar bg-info" role="progressbar" style="width: 50%;" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
</div>

动画效果

通过 .progress-bar-animated.progress-bar-striped 添加条纹和动画。

示例代码:

<div class="progress">
  <div class="progress-bar progress-bar-striped progress-bar-animated" role="progressbar" style="width: 75%;" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
  • .progress-bar-striped:添加条纹。
  • .progress-bar-animated:添加动画。

动态控制

通过 JavaScript 动态更新进度。

示例代码:

<div class="progress">
  <div id="dynamicProgress" class="progress-bar" role="progressbar" style="width: 0%;" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<button onclick="updateProgress()">增加进度</button>

<script>
  let progress = 0;
  const progressBar = document.getElementById('dynamicProgress');

  function updateProgress() {
    progress += 10;
    if (progress > 100) progress = 0;
    progressBar.style.width = progress + '%';
    progressBar.setAttribute('aria-valuenow', progress);
    progressBar.textContent = progress + '%';
  }
</script>

出站链接:参考 Bootstrap 5 JavaScript


注意事项

  • 依赖性:Progress Bars 不需 JavaScript,仅依赖 CSS(动画除外)。
  • 可访问性:始终使用 aria-valuenowaria-valueminaria-valuemax
  • 对比度:确保进度条颜色与背景有足够对比度。
  • 动态更新:频繁更新进度时,避免影响页面性能。

参考资料

以下是与 Bootstrap 5 Progress Bars 相关的外部资源:


总结

Bootstrap 5 的 Progress Bars 是一个简单而实用的组件,支持自定义颜色、高度和动画效果。通过简单的类和 JavaScript,您可以实现动态的进度展示。如果您有具体问题或场景,请随时告诉我!