@gfazioli/mantine-spinner

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

一个以SVG为主的加载自旋器为主的Mantine React组件,由多个动画变体,片段形状,梯度颜色,发光效果,进步模式,和复合组件组成.

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

曼汀自旋组件

mantine Spinner

mantine-spinner 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
制造的 外观卡 * 每日刷新

概览

[注] 自由受马特·坎农的启发 代码Pen

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

曼汀螺旋桨 是一个功能丰富的 React 组件,旨在在基于曼汀的应用中提供平滑,自定义的加载动画. 它暴露了视觉调谐的控制——包括整体尺寸,内半径,分数,中风厚度,动画持续时间,方向,以及更多——这样你就可以将你的品牌和上下文相匹配,从细微的内置加载器到显著的页级指标.

特征

  • 动画变体 —— 说 fade, (中文(简体) ), pulse, (中文(简体) ), grow, (中文(简体) ), trail 有自定义的时间
  • 线段形状 —— 说 line, (中文(简体) ), dot, (中文(简体) ), arc 对于不同的视觉样式
  • 渐变颜色 ——平滑相间颜色插值
  • 发光效果 —— SVG gaussian 有可调整强度的模糊过滤器
  • 色调旋转 连续彩虹彩色循环
  • 进度模式 确定进度指标(0-100%) role="progressbar"
  • 化合物组件 —— 说 Spinner.Group 以便堆积在一起, Spinner.Overlay 用于加载覆盖
  • 无障碍 —— 说 role="status", (中文(简体) ), aria-label, (中文(简体) ), prefers-reduced-motion 支助
  • 儿童支助 ——以自旋器内部为中心的内容
  • 曼汀样式 API ——满 classNames, (中文(简体) ), styles变量支持

为了避免SSR环境中的水分不匹配,自旋器专门对客户端进行调取,因为其SVG几何学依赖于浮点数学,这在服务器和浏览器之间可能有所不同. 通过软件包CSS(带有可选的)提供样式@layer mantine-spinner )与现代的CSS分层和Mantine的设计系统整合,从而产生可靠、视觉一致的加载经验.

[!注]

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

安装

npm install @gfazioli/mantine-spinner

或者说

yarn add @gfazioli/mantine-spinner

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

import '@gfazioli/mantine-spinner/styles.css';

使用量

import { Spinner } from '@gfazioli/mantine-spinner';

function Demo() {
  return <Spinner />;
}

更多实例

// Trail variant with glow (neon effect)
<Spinner variant="trail" glow={3} color="cyan" minOpacity={0.3} />

// Dot shape with gradient
<Spinner segmentShape="dot" gradient={{ from: 'blue', to: 'cyan' }} />

// Progress indicator with label
<Spinner progress={65} color="teal">
  <Text>65%</Text>
</Spinner>

// Concentric group
<Spinner.Group>
  <Spinner size={100} color="blue" />
  <Spinner size={60} color="cyan" direction="counter-clockwise" />
</Spinner.Group>

// Loading overlay
<Spinner.Overlay visible={isLoading}>
  <Card>Content</Card>
</Spinner.Overlay>

发起人

你的支持帮助了我:

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

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

你的帮助真的很重要.

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


https://github.com/user-attachments/assets/2401bfe1-e829-4057-a654-7d0a895a9605 互联网档案馆的存檔,存档日期2013-12-20

版本与发布记录

@gfazioli/mantine-spinner 共发布 61 个版本,首次发布于 2025/02/07;过去 12 个月发布了 36 个版本。

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

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

@gfazioli/mantine-spinner 是什么?

一个以SVG为主的加载自旋器为主的Mantine React组件,由多个动画变体,片段形状,梯度颜色,发光效果,进步模式,和复合组件组成.

如何安装 @gfazioli/mantine-spinner?

在项目目录运行 npm install @gfazioli/mantine-spinner,或使用 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-spinner 支持 TypeScript 吗?

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

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

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

@gfazioli/mantine-spinner 可以商用吗?

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

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

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

@gfazioli/mantine-spinner 还在维护吗?

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