@ gentleduck/ 日历
无头型,框架-不可知日历引擎有日期适配器模式,反应钩和复合组件.
麻省理工学院 - 说吧 更改日志 - 说吧 捐款 - 说吧 文档
75%小于每日采集反应器 - ~5 KB克齐比特对~20 KB. 零从属. 全键盘导航和ARIA合规.
基准
| 图书馆 | 大小( gzip) | 依赖关系 |
|---|---|---|
| @ gentleduck/ 日历 | ~5 KB 键 | 0 个 |
| 反应日选择器 | ~20 KB 键 | 日期 - fns |
| 反应-日历 | ~18 KB 键 | 0 个 |
| 反应- 日期选择器 | ~38 KB (韩语) | 日期fns,反应-流行 |
| 反应-aria (DatePicker) | ~45 KB (英语) | @ 国际化/日期+5 |
4个历法系统(希腊语,伊斯兰教,波斯语,希伯来语). 7个日期适配器(Native, date-fns, dayjs, luxon + 3个日历专用). 见 全部基准 用于特性比较.
bun run benchmark
快速启动
import { NativeAdapter, useCalendar } from '@gentleduck/calendar'
const adapter = new NativeAdapter()
function MyCalendar() {
const { state, getDayProps, getGridProps } = useCalendar({
adapter,
mode: 'single',
})
return (
<div {...getGridProps()}>
{state.weeks.map(week =>
week.days.map(day => (
<button key={day.date.getTime()} {...getDayProps(day)}>
{day.date.getDate()}
</button>
))
)}
</div>
)
}
特征
- 日期适应器模式 - 插入任何日期库(日期、日期、日期、时间)
- 选择模式 - 单一、范围、多选择和类型安全条件类型
- 多月数 - 并列显示1至12个月
- 时间选择器 - 使用带有自旋按钮的TimePicker钩ARIA
- 约会时间拾取器 - 使用DateTime编译日历+时间
- 键盘导航 - 箭头密钥、页上/下、主/端、输入/空间、逃逸
- 屏幕阅读器 - 关于导航和选择的线活性公告
- 正在移动 TabIndex - 与DOM焦点同步进行适当的重点管理
- 无 CSS - 使用 Tailwind、 CSS 模块或 vanilla CSS 的带有数据* 属性的样式
- 可树动 - 说吧
sideEffects: false,只导入您使用的东西
建筑
@gentleduck/calendar
├── adapter/ - DateAdapter<TDate> interface + NativeAdapter
├── grid/ - buildCalendarMonth, buildMultiMonth, year/decade views
├── selection/ - selectDay, applySelection, range/multi logic
├── navigation/ - navigate, canNavigate, month/year jumping
├── time/ - TimeValue, clampTime, incrementField, formatters
└── react/ - useCalendar, useTimePicker, useDateTime, useKeyboard, useAnnouncer
文档
完整文件时间 greatduck.org/docs/packages/duck-日历
许可证
麻省理工学院