---
url: /components/gantt-progress.md
---
# GanttProgress 甘特式阶段进度

甘特式阶段进度柱：各阶段按状态（completed / active / pending）呈现不同高度与配色，贯穿连接线表达整体推进比例，active 阶段自带脉冲动画。适合项目里程碑、迭代阶段、上线流程等「阶段推进」场景。

## 基础用法

`stages` 数组声明各阶段，`status` 取 `completed / active / pending`，高度按状态自动区分（1 / 0.7 / 0.35）。

## 阶段日期标注

阶段可携带 `date` 字段，显示在阶段名下方（如计划完成时间）。

## 自定义阶段高度

`height` 覆盖状态默认高度（0 ~ 1，相对栅格总高的比例），可强调关键阶段。

## 自定义颜色

`completed-color` / `active-color` / `pending-color` 三组颜色覆盖，可做健康度语义（如风险项转橙）。

## 项目落地：迭代里程碑

与 PageHeader / StatCard 组合成迭代进度计划视图（完整用法见[项目协作示例](/examples/project)）。

## API