@gfazioli/mantine-rings-progress

中文文档
4.1.18发布于 2026/11/09MITTypeScriptESM + CJS零依赖近 30 天下载 3705

由Apple Watch活性环所激发出的一个"曼汀9"同心环进取组件——动画,发光,可访问,每环定制.

中文使用文档
文档目录5 节
  1. 概览
  2. 特征
  3. 安装
  4. 使用量
  5. 发起人

曼汀环式进展组件

Mantine Rings Progress

mantine-rings-progress at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
制造的 外观卡 * 每日刷新

概览

此组件创建于 曼汀语Name 图书馆. 这需要 曼汀 9.x (英语) 财务报告和审定财务报表 反应 19。 。 。 .

曼汀环行进展 是一个Mantine UI扩展,它使多个同心环进展指标——受苹果观察活动环的启发. 每个环由一个值和颜色定义,组件将本地曼汀包裹 RingProgress 有丰富的定制选项.

特征

  • 每环定制 - 覆盖 thickness, (中文(简体) ), roundCaps,以及 rootColor 单个环
  • 每环线性梯度 ——用两站梯度来画出一圈中风 gradient: { from, to, deg? }
  • 每环值标签 —— 说 showValues (或每环) showValue)在每个弧的端点投出一种有样式的药丸,并带有自定义 formatValue
  • 每环相互作用 —— 说 onClick 财务报告和审定财务报表 onHover 调用 几何测试,所以右环会起火,即使它们的包裹重叠
  • 输入动画 动画从0到目标值
  • 错位动画 ——动脉相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相相接相相接相相接相相相接相相接相接相相相相相相相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相
  • 动画值变化 —— 说 animateValueChanges 在挂载后插入值更新( 对活的仪表板来说很棒)
  • 发光/ 霓虹效应 —— 说 drop-shadow 沿环形发光,每环强度和颜色
  • 完成后脉冲 ——当一环达到100%时有微波脉冲动动画,其中 onRingComplete 回调
  • 开始角度和方向( F) ——自定义环开始填充的地点和方向(顺时针/逆时针)
  • 统一工具提示 —— 说 withTooltip 显示类似图表的工具提示, 上面有所有环的颜色表
  • 无障碍 —— 说 role="progressbar" 每个环上都有 ARIA 属性,键盘激活可点击环, prefers-reduced-motion 支助
  • 中央标签 — 显示以环为中心的任何反应节点(文本、 emoji、 组件)

[!注]

→ 演示文稿和文件 → Youtube 视频 → 更多曼汀组件

安装

npm install @gfazioli/mantine-rings-progress

或者说

yarn add @gfazioli/mantine-rings-progress

在应用程序根部安装导入包样式后:

import '@gfazioli/mantine-rings-progress/styles.css';

使用量

import { RingsProgress } from '@gfazioli/mantine-rings-progress';

function Demo() {
  const rings = [
    { value: 75, color: 'green' },
    { value: 50, color: 'blue' },
    { value: 90, color: 'orange' },
  ];

  return (
    <RingsProgress
      size={180}
      rings={rings}
      animate
      staggerDelay={300}
      transitionDuration={1000}
      glow={6}
    />
  );
}

发起人

你的支持帮助了我:

  • 积极维护项目,及时修复错误并更新安全信息
  • 添加新特性, 提高性能,并完善开发者的经验
  • 扩大测试范围和文件,以更顺利地采用
  • 确保长期可持续性而不依赖临时自由时间
  • 优先处理最重要的社区请求和路线图项目

开放源码的繁荣,如果受益的人能够回报——即使每月的小额捐款也会产生真正的变化。 赞助有助于覆盖维护时间、基础设施和无数使项目保持健康的无形任务.

你的帮助真的很重要.

💚 成为提案国 今天,帮助我保持这一项目的可靠性,更新,并为每个人成长.


https://github.com/user-attachments/assets/de494ff9-5e3c-4026-bdc3-0402110917e7 互联网档案馆的存檔,存档日期2013-12-27

版本与发布记录

@gfazioli/mantine-rings-progress 共发布 69 个版本,首次发布于 2024/02/13;过去 12 个月发布了 30 个版本。

版本发布日期距今
4.1.18latest2026/11/096 天前
4.1.172026/11/069 天前
4.1.162026/10/2621 天前
4.1.152026/10/2224 天前
4.1.142026/10/131 个月前
4.1.132026/10/101 个月前

关于 @gfazioli/mantine-rings-progress 的常见问题

@gfazioli/mantine-rings-progress 是什么?

由Apple Watch活性环所激发出的一个"曼汀9"同心环进取组件——动画,发光,可访问,每环定制.

如何安装 @gfazioli/mantine-rings-progress?

在项目目录运行 npm install @gfazioli/mantine-rings-progress,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-rings-progress 支持 TypeScript 吗?

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

@gfazioli/mantine-rings-progress 支持 ESM 还是 CommonJS?

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

@gfazioli/mantine-rings-progress 可以商用吗?

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

@gfazioli/mantine-rings-progress 的下载量有多少?

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

@gfazioli/mantine-rings-progress 还在维护吗?

最新版本 4.1.18 发布于 2026/11/09(6 天前);至今共发布 69 个版本,其中过去 12 个月发布了 30 个;首次发布于 2024/02/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。