Gantt Chart Component
Biểu đồ Gantt tương tác cao cấp, mượt mà dành cho quản lý dự án, lộ trình sản phẩm (Roadmap), phân cấp nhiệm vụ lồng nhau (Hierarchy Tree) và quản lý cột mốc (Milestones). Hỗ trợ kéo thả trực quan, liên kết phụ thuộc và tự động đồng bộ giao diện Dark/Light mode.
Đa chế độ xem
Xem linh hoạt theo Ngày, Tuần, Tháng, Quý và Năm.
Phụ thuộc & Kéo thả
Tạo đường liên kết Finish-to-Start trực tiếp trên timeline.
Tailwind v4 Token
Tự động ăn theo màu sắc, đường viền và Dark mode của ChillCMS.
Hiệu năng cao
Virtualization mượt mà, hỗ trợ hàng nghìn công việc cùng lúc.
Ví dụ 1: Quản lý Tiến độ Dự án Cơ bản
Bao gồm bảng thông tin công việc bên trái, thanh timeline trực quan bên phải, thanh tìm kiếm/lọc task, các nút phóng to/thu nhỏ và chế độ xem toàn màn hình.
Tiến độ Nâng cấp ChillCMS 2.0
Quản lý tiến độ dự án, các giai đoạn và quan hệ phụ thuộc công việc
Bấm vào một thanh công việc hoặc hàng trên bảng để xem chi tiết.
Nhiệm vụ thường Nhóm Epic Cột mốc (Milestone)
Cách sử dụng trong ứng dụng (Quick Start)
import { GanttChart } from '~/components/ui/gantt-chart';
const tasks = [
{
id: 1,
text: 'Phát triển Tính năng Mới',
start: new Date(2025, 2, 1),
duration: 10,
progress: 60,
type: 'task',
},
{
id: 2,
text: 'Cột mốc Phát hành Alpha',
start: new Date(2025, 2, 11),
type: 'milestone',
},
];
const links = [
{ id: 1, source: 1, target: 2, type: 'fs' },
];
export default function MyTimeline() {
return (
<GanttChart
tasks={tasks}
links={links}
viewMode="week"
title="Tiến độ Dự án"
showViewModeSelector
showZoomControls
showSearchFilter
height={500}
/>
);
}Bảng tham số Props (API Reference)
| Tên Prop | Kiểu dữ liệu | Mặc định | Mô tả |
|---|---|---|---|
| tasks | GanttTask[] | Bắt buộc | Danh sách công việc cần hiển thị trên timeline và bảng. |
| links | GanttLink[] | [] | Danh sách mối liên kết phụ thuộc (Finish-to-Start, v.v.). |
| viewMode | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'week' | Độ phân giải thời gian timeline. |
| theme | 'auto' | 'willow' | 'willow-dark' | 'material' | 'auto' | 'auto' ăn theo Tailwind CSS v4 design tokens của ChillCMS. |
| readonly | boolean | false | Bật chế độ chỉ xem, ngăn thao tác kéo thả và sửa dữ liệu. |
| toolbar | boolean | false | Hiển thị thanh Svar Toolbar chuyên dụng với các nút hotkeys. |
| editor | boolean | true | Kích hoạt hộp thoại Task Editor khi nhấp đúp chuột. |
| height | string | number | 540 | Chiều cao vùng Gantt Chart (tính theo pixel hoặc CSS string). |
| columns | false | GanttColumn[] | DEFAULT_GANTT_COLUMNS | Cấu hình các cột ở bảng bên trái hoặc truyền false để ẩn bảng. |
| onInit | (api: GanttApi) => void | undefined | Callback nhận API instance điều khiển Svar Gantt chuyên sâu. |