@chakra-ui/progress

中文文档
2.2.0发布于 2023/07/19MITTypeScriptESM + CJS近 30 天下载 127.3万

Chakra UI 的进展栏组件

中文使用文档
文档目录18 节
  1. 安装
  2. 导入组件
  3. 使用量
  4. 线性进度
  5. 颜色
  6. 大小
  7. 不确定
  8. 有条纹
  9. 动画
  10. 带有标签
  11. 循环进度
  12. 循环进度大小
  13. 循环进度颜色
  14. 标签的循环进度
  15. 无障碍
  16. 说明
  17. 循环进展
  18. 旋转器

进展

进步部分是显示进步状况的一个要素 任务需要很长时间,或包括几个步骤.

安装

yarn add @chakra-ui/progress

# or

npm i @chakra-ui/progress

导入组件

import {
  Progress,
  ProgressLabel,
  CircularProgress,
  CircularProgressLabel,
} from "@chakra-ui/progress"

使用量

<Progress value={50} />

线性进度

<Progress value={50} />

颜色

通过 color 将主题中存在的颜色应用到 进展

<Progress color="pink" value={20} />

大小

通过 size 提高进展高度的道具

<Progress size="sm" value={20} />
<Progress size="lg" value={20} />

不确定

通过 value 进展情况报告 undefined 进展部分 状态

<Progress margin="20px" size="xs" value={undefined} />

有条纹

通过 hasStripe 具有美丽的梯度来创建条纹 对进展的影响

<Progress color="green" hasStripe value={20} />

动画

通过 isAnimated 道具与 hasStrip 得到一个道具 美丽的动画进步

<Progress hasStripe isAnimated value={20} />

带有标签

使用 ProgressLabel 要为进度设置标签的效用组件 组件

<Progress value={60}>
  <ProgressLabel>60%</ProgressLabel>
</Progress>

循环进度

<CircularProgress value={50} />

循环进度大小

通过 size 来改变循环进度的大小 。 你也可以这样 通过 thickness 来改变循环进度的厚度。 这个 thickness 道具是一个分数值,其实际值由 size 通知进展。 在这个例子中,该通知的进展将 a 厚度为30px. 大小的50% (120px) * 30px

<CircularProgress size="120px" thickness={0.5} value={60} />

循环进度颜色

通过 color 应用主题中任何颜色的道具

<CircularProgress color="pink" value={20} />

标签的循环进度

使用 CircularProgressLabel 要设置标签的公用设备组件 循环进展

<CircularProgress value={60}>
  <CircularProgressLabel>60%</CircularProgressLabel>
</CircularProgress>

无障碍

  • 进步可以被设定为进步栏,以表示进步栏
  • 进度现在定为完成率 ,以确保在屏幕阅读器中可以看到进展百分比.

说明

《通报进展》和《Spinner》似乎也有同样的目的,但 他们不会的 在那个 indeterminate 声明如下: 差别.

循环进展

它用来表示一项决定性行动的进展。 比如说 图像上传操作 :

  • 在上传开始前,上传进度不确定(此时, 它只是旋转,
  • 一旦我们知道图像的大小 并开始上传(使用轴心) 更新《通报进展》的进展值(此时显示 页:1 循环进步也伴随着 aria-* 属性,使其 屏幕阅读器可访问进度值.

循环进步也伴随着 aria- * 属性来取得进展 可供屏幕阅读者访问的值.

旋转器

它更是一种“介绍性”的加载指标,您可以在页面上使用 组件,在装载时,或在其产生之前。 没有 语义之义.

为了赋予斯宾纳/加载指标意义,ARIA标准要求您 标记正在装入的组件/页面的区域 aria-busy=true。 。 。 .

版本与发布记录

@chakra-ui/progress 共发布 421 个版本,首次发布于 2020/06/21;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.2.0latest2023/07/193 年前
0.0.0-dev-20230718132637dev2023/07/183 年前
0.0.0-dev-202307181307422023/07/183 年前
0.0.0-dev-202307181247172023/07/183 年前
0.0.0-dev-202307181223362023/07/183 年前
2.1.62023/03/233 年前

其他发布通道:canary → 0.0.0-canary-2021118164051,pr → 0.0.0-pr-202212011232,next → 2.0.0-next.2,next-dev → 0.0.0-next-dev-202241614737,dev → 0.0.0-dev-20230718132637。

关于 @chakra-ui/progress 的常见问题

@chakra-ui/progress 是什么?

Chakra UI 的进展栏组件

如何安装 @chakra-ui/progress?

在项目目录运行 npm install @chakra-ui/progress,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)、@chakra-ui/system(>=2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@chakra-ui/progress 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chakra-ui/progress 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@chakra-ui/progress 可以商用吗?

@chakra-ui/progress 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chakra-ui/progress 的下载量有多少?

根据 npm 官方下载统计,@chakra-ui/progress 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,273,070 次,日均约 42,436 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chakra-ui/progress 还在维护吗?

最新版本 2.2.0 发布于 2023/07/19(3 年前);至今共发布 421 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/06/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。