曼汀钟组件
制造的 外观卡 * 每日刷新
概览
此组件创建于 曼汀语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合规和屏幕阅读器支持构建
发起人
你的支持帮助了我:
- 积极维护项目,及时修复错误并更新安全信息
- 添加新特性, 提高性能,并完善开发者的经验
- 扩大测试范围和文件,以更顺利地采用
- 确保长期可持续性而不依赖临时自由时间
- 优先处理最重要的社区请求和路线图项目
开放源码的繁荣,如果受益的人能够回报——即使每月的小额捐款也会产生真正的变化。 赞助有助于覆盖维护时间、基础设施和无数使项目保持健康的无形任务.
你的帮助真的很重要.
💚 成为提案国 今天,帮助我保持这一项目的可靠性,更新,并为每个人成长.