在实际项目中,甘特图的任务时间跨度往往差异显著——有的任务横跨数月甚至数年,有的却仅有短短几天。若时间轴默认逐日显示,长跨度任务会导致单元格密集排布,视觉上显得拥挤不堪;反之,若逐月显示,短周期任务的细节则可能被掩盖。vxe-gantt 提供了一个实用的配置项:scales 中的 step 属性,允
在实际项目中,甘特图的任务时间跨度往往差异显著——有的任务横跨数月甚至数年,有的却仅有短短几天。若时间轴默认逐日显示,长跨度任务会导致单元格密集排布,视觉上显得拥挤不堪;反之,若逐月显示,短周期任务的细节则可能被掩盖。vxe-gantt 提供了一个实用的配置项:scales 中的 step 属性,允许自定义日期轴的显示跨度,从而灵活控制时间轴的密度,使甘特图兼具紧凑性与清晰度。
step 参数作用于 scales 数组中的每个时间层级,其含义简明:跳过 N 个单位来显示刻度。例如,在月层级设置 step: 2,意味着每隔一个月显示一个刻度。
长期稳定更新的攒劲资源: >>>点此立即查看<<<
| 层级类型 | step 含义 | 示例 |
|---|---|---|
| year(年) | 每隔 N 年显示一个刻度 | step: 2 → 2020, 2022, 2024... |
| month(月) | 每隔 N 个月显示一个刻度 | step: 3 → 1月, 4月, 7月, 10月... |
| week(周) | 每隔 N 周显示一个刻度 | step: 2 → 第1周, 第3周, 第5周... |
| date(天) | 每隔 N 天显示一个刻度 | step: 5 → 1日, 6日, 11日, 16日... |
当任务时间跨度较长(数月至数年)时,逐月显示往往导致轴标签密集排列,视觉上显得拥挤。通过设置 step: 2,可使刻度每隔一个月出现一次,显著提升可读性。

复制代码
| 配置 | 效果 |
|---|---|
| scales: ['year', 'month'] | 时间轴分为"年"和"月"两层 |
| month: { step: 2 } | 底层仅显示 1月、3月、5月...(隔月显示) |
| cellWidth 未设置 | 使用默认宽度,配合 step 使单元格变宽,显示更为疏朗 |
当任务时间跨度较短(数天至数周)且任务密集时,逐日显示可能导致单元格过窄,任务条相互重叠,细节难以辨识。通过设置 step: 3,每隔 3 天显示一个刻度,可使画面更加清爽。

复制代码
| 配置 | 作用 | 推荐组合 |
|---|---|---|
| step 增大 | 刻度变稀,每格代表的时间跨度变大 | 配合适中的 cellWidth(如 80-120px) |
| step 减小(或默认 1) | 刻度变密,每格代表的时间跨度变小 | 配合较大的 cellWidth(如 120-200px)避免拥挤 |
| cellWidth 固定 | 每个单元格宽度固定,step 决定单元格代表的实际时间量 | 适用于时间跨度固定的场景 |
| 视图类型 | 时间跨度 | 推荐 scales 配置 | 说明 |
|---|---|---|---|
| 年视图 | 5-10 年 | [{ type: 'year', step: 1 }] | 每年一个刻度 |
| 年视图(稀疏) | 10+ 年 | [{ type: 'year', step: 2 }] | 每2年一个刻度 |
| 月视图 | 1-3 年 | ['year', { type: 'month', step: 1 }] | 每月一个刻度 |
| 月视图(季度) | 2-5 年 | ['year', { type: 'month', step: 3 }] | 每季度一个刻度 |
| 月视图(半年) | 5+ 年 | ['year', { type: 'month', step: 6 }] | 每半年一个刻度 |
| 天视图 | 1-3 个月 | ['month', { type: 'date', step: 1 }] | 每日一个刻度 |
| 天视图(稀疏) | 3-12 个月 | ['month', { type: 'date', step: 5 }] | 每5天一个刻度 |
| 周视图 | 3-12 个月 | ['month', { type: 'week', step: 1 }] | 每周一个刻度 |
| 周视图(双周) | 6-24 个月 | ['month', { type: 'week', step: 2 }] | 每两周一个刻度 |
核心配置口诀:跨度大则 step 大,跨度小则 step 小;顶层管宏观,底层管细节。
侠游戏发布此文仅为了传递信息,不代表侠游戏网站认同其观点或证实其描述