@gfazioli/mantine-clock

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

以时区支持,倒计时计时器,定制选项,以及实时更新为曼汀的回放时钟组件和钩子.

中文使用文档
文档目录10 节
  1. 概览
  2. 安装
  3. 使用量
  4. 时钟组件
  5. 使用时钟钩
  6. 使用时钟下方 钩子
  7. 造型和赛明
  8. 高级示例
  9. 特征
  10. 发起人

曼汀钟组件

Mantine Clock

mantine-clock 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。 。 。 .

曼汀钟 既提供模拟时钟组件,又提供为React应用量身定制的时间管理钩.

时钟支持通过一个值道克进行活的勾选或静态显示,多种二手行为(smooth, chick, half-tick),并且通过类名和样式 API(包括控制滴答、数字、手、中点,以及类似“Neon Cyber Clock”的标点外观)进行丰富的样式显示。 它进一步使视觉扇形弧能动态地与当前秒,分和小时的手位置相接,具有精确的起动规则,方向,颜色和不透明性.

[!注]

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

安装

npm install @gfazioli/mantine-clock dayjs

或者说

yarn add @gfazioli/mantine-clock dayjs

dayjs 是一个对等的依赖: 时钟读取并转换时间( 它 ) utc 财务报告和审定财务报表 timezone 插件),所以如果您的应用程序还没有,就同时安装.

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

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

使用量

Mantine Clock 库为使用Mantine的React应用中的时间管理和可视化提供了强大的组件和钩子.

时钟组件

创建具有实时更新或静态时间显示的模拟时钟 :

import { Clock } from '@gfazioli/mantine-clock';

// Real-time clock
function LiveClock() {
  return <Clock />;
}

// Static clock showing specific time
function StaticClock() {
  return <Clock value={new Date('2023-12-25T15:30:00')} running={false} />;
}

// Customized clock with timezone
function WorldClock() {
  return (
    <Clock 
      timezone="America/New_York"
      size={200}
      hourHandColor="blue"
      minuteHandColor="cyan"
      secondHandColor="red"
    />
  );
}

使用时钟钩

以灵活格式获取实时数据 :

import { useClock } from '@gfazioli/mantine-clock';

function DigitalClock() {
  const { hours, minutes, seconds, amPm, isRunning } = useClock({
    timezone: 'UTC',
    use24Hours: false,
    padHours: true,
    padMinutes: true,
    padSeconds: true
  });

  return (
    <div>
      {hours}:{minutes}:{seconds} {amPm}
    </div>
  );
}

使用时钟下方 钩子

创建带有目标日期或期限的倒计时器 :

import { useClockCountDown } from '@gfazioli/mantine-clock';

// Countdown to specific date
function EventCountdown() {
  const { day, hours, minutes, seconds } = useClockCountDown({
    targetDate: new Date('2024-12-31T23:59:59'),
    onCountDownCompleted: () => alert('Happy New Year!')
  });

  return (
    <div>
      Time remaining: {day}d {hours}h {minutes}m {seconds}s
    </div>
  );
}

// Countdown from duration
function TimerCountdown() {
  const { minutes, seconds, isRunning } = useClockCountDown({
    minutes: 25, // 25-minute Pomodoro timer
    onCountDownCompleted: () => console.log('Break time!')
  });

  return (
    <div>
      Pomodoro: {minutes}:{seconds}
    </div>
  );
}

造型和赛明

图书馆与曼汀的主题集成无缝:

import '@gfazioli/mantine-clock/styles.css';
// or with CSS layers
import '@gfazioli/mantine-clock/styles.layer.css';

// Custom styled clock with available CSS variables
function ThemedClock() {
  return (
    <Clock 
      style={{
        '--clock-color': 'var(--mantine-color-blue-1)',
        '--clock-hour-ticks-color': 'var(--mantine-color-blue-6)',
        '--clock-minute-ticks-color': 'var(--mantine-color-blue-4)',
        '--clock-primary-numbers-color': 'var(--mantine-color-blue-9)',
        '--clock-secondary-numbers-color': 'var(--mantine-color-blue-7)',
        '--clock-hour-hand-color': 'var(--mantine-color-blue-8)',
        '--clock-minute-hand-color': 'var(--mantine-color-blue-6)',
        '--clock-second-hand-color': 'var(--mantine-color-red-6)'
      }}
      className="my-custom-clock"
    />
  );
}

高级示例

// Multi-timezone dashboard
function WorldClockDashboard() {
  const timezones = [
    { name: 'New York', tz: 'America/New_York' },
    { name: 'London', tz: 'Europe/London' },
    { name: 'Tokyo', tz: 'Asia/Tokyo' }
  ];

  return (
    <div style={{ display: 'flex', gap: '2rem' }}>
      {timezones.map(({ name, tz }) => (
        <div key={tz}>
          <h3>{name}</h3>
          <Clock timezone={tz} size={150} />
        </div>
      ))}
    </div>
  );
}

// Clock with custom number visibility and styling
function CustomNumbersClock() {
  return (
    <Clock 
      primaryNumbersOpacity={1}
      secondaryNumbersOpacity={0.5}
      primaryNumbersColor="blue"
      secondaryNumbersColor="gray"
      size={200}
    />
  );
}

// Countdown with controls
function ControllableCountdown() {
  const countdown = useClockCountDown({
    minutes: 10,
    enabled: false
  });

  return (
    <div>
      <div>{countdown.minutes}:{countdown.seconds}</div>
      <button onClick={countdown.start}>Start</button>
      <button onClick={countdown.pause}>Pause</button>
      <button onClick={countdown.resume}>Resume</button>
      <button onClick={countdown.reset}>Reset</button>
    </div>
  );
}

特征

  • 实时更新: 可配置频率自动时间同步
  • 时区支持: 全球时区与IANA时区数据库的兼容性
  • 时钟. 数字:带有AM/PM、日期和自定义分隔器的数字时钟显示的复合组件
  • 响应大小:基于断点的响应分量{ base: "sm", md: "lg" })使用曼汀本地CSS媒体查询
  • 时钟形状: 圆形和圆形矩形( Apple Watch 样式) , 有可配置的外观比
  • 扇形弧:视觉弧对接秒、分和小时手
  • 自定义手渲染:通过制取道具进行全面控制,持续小时、分钟和二手
  • 上山动画: 从中午12:00起进入动画
  • 倒计时器数字 : useClockCountDown 勾起目标日期、期限和完成回调
  • 自定义样式: 通过样式 API 和 CSS 变量全面控制外观
  • 类型脚本支持: 完整类型定义,以增进开发者的经验
  • 无障碍: 以WCAG合规和屏幕阅读器支持构建

发起人

你的支持帮助了我:

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

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

你的帮助真的很重要.

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


https://github.com/user-attachments/assets/727a8634-28ee-4279-80b1-dcf2cb7f5961 互联网档案馆的存檔,存档日期2013-12-21

版本与发布记录

@gfazioli/mantine-clock 共发布 48 个版本,首次发布于 2025/08/02;过去 12 个月发布了 35 个版本。

版本发布日期距今
4.0.20latest2026/11/096 天前
4.0.192026/11/069 天前
4.0.182026/10/2621 天前
4.0.172026/10/2224 天前
4.0.162026/10/131 个月前
4.0.152026/10/101 个月前

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

@gfazioli/mantine-clock 是什么?

以时区支持,倒计时计时器,定制选项,以及实时更新为曼汀的回放时钟组件和钩子.

如何安装 @gfazioli/mantine-clock?

在项目目录运行 npm install @gfazioli/mantine-clock,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:dayjs(^1.11.13)、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-clock 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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