Schedule-X 项目新增周视图自定义范围功能解析

功能背景

Schedule-X 是一款现代化的日程管理组件库，近期社区提出了一个增强功能需求：希望能够自定义周视图显示的天数范围。这个功能对于需要隐藏周末或者显示非标准周视图的用户特别有用。

功能实现方案

经过社区讨论和开发者评估，最终决定通过 weekOptions 中的 nDays 参数来实现这一功能。这个设计决策基于以下几点考虑：

1. 简洁性：通过单一参数控制显示天数，API设计简单直观
2. 兼容性：确保与现有功能特别是拖拽操作的兼容
3. 灵活性：支持各种天数配置，如5天(工作日)、7天(完整周)或14天(双周视图)

技术实现细节

核心参数说明

nDays 参数允许开发者自由配置周视图显示的天数：

• 设置为5：显示周一到周五，自动隐藏周末
• 设置为7：显示完整一周
• 设置为14：显示两周视图
• 其他任意数字：按需自定义显示天数

视图导航逻辑

与 nDays 配套的还有视图导航逻辑：

• 默认情况下，前后导航以7天为步长
• 开发者可通过配置调整导航步长，实现按天、按周或自定义周期的导航

设计取舍

在方案讨论过程中，社区曾提出更灵活的 onRenderDay 回调方案，该方案理论上可以提供更细粒度的控制，如：

• 动态显示/隐藏特定日期
• 自定义日期样式
• 添加特殊标记

但最终未被采纳，主要原因是：

1. 拖拽兼容性问题：中间隐藏日期会导致拖拽逻辑复杂化
2. 性能考虑：回调方式可能影响渲染性能
3. API一致性：保持组件API的简洁性和一致性

使用场景示例

这一功能特别适用于以下场景：

1. 企业应用：只显示工作日的5天视图
2. 教育系统：显示两周课程表
3. 项目管理：自定义周期视图，如10天冲刺视图
4. 排班系统：灵活配置显示周期

未来扩展方向

虽然当前实现了基础功能，但仍有扩展空间：

1. 动态调整：运行时动态改变显示天数
2. 非连续日期：支持显示不连续的日期组合
3. 响应式配置：根据屏幕尺寸自动调整显示天数

总结

Schedule-X 通过新增的 nDays 配置项，为周视图提供了强大的自定义能力，平衡了功能需求与技术实现的复杂度。这一改进使得组件能够适应更多业务场景，同时保持了API的简洁性和功能的稳定性。开发者现在可以更灵活地配置日程显示方式，满足各种专业场景下的可视化需求。