Timeline
Timeline thuộc nhóm Hiển thị dữ liệu. Xem demo trực tiếp, cách tích hợp và các lưu ý triển khai.
Bắt đầu nhanh
Import Timeline từ entry của gói Free. Các ví dụ bên dưới thể hiện những kiểu tương tác và cấu hình được hỗ trợ.
import { Timeline } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử Timeline thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
Tham chiếu API
Tra cứu các thuộc tính, kiểu dữ liệu được chấp nhận, giá trị mặc định và lưu ý về hành vi.
Dữ liệu được sinh từ API TypeScript công khai của thư viện. Kiểu dữ liệu, thuộc tính bắt buộc và giá trị mặc định luôn đồng bộ với mã nguồn.
Timeline
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
align | Căn nội dung so với đường timeline. | Align | — |
variant | Kiểu hiển thị cho item (default, outlined, card, minimal, modern, gradient). | Variant | — |
size | Kích thước marker và khoảng cách (sm, md, lg, xl). | Size | — |
mode | Hướng bố trí (vertical hoặc horizontal). | Mode | — |
lineColor | Màu của đường nối. | string | — |
lineStyle | Kiểu đường nối (solid, dashed, dotted). | LineStyle | — |
items | Danh sách items (thay cho children). | TimelineItemProps[] | — |
itemClassName | Class áp dụng cho mỗi item. | string | — |
animate | Animate items on mount | boolean | — |
dense | Compact spacing | boolean | — |
showLine | Show connecting line | boolean | — |
TimelineItem
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
title | Tiêu đề chính của item. | React.ReactNode | — |
description | Mô tả phụ bên dưới tiêu đề. | React.ReactNode | — |
time | Nhãn thời gian hiển thị bên dưới. | React.ReactNode | — |
icon | Icon hiển thị cạnh nội dung. | React.ComponentType<{ className?: string }> | — |
status | Trạng thái màu của marker. | "default" | "primary" | "success" | "warning" | "error" | "info" | "default" |
color | Màu sắc tuỳ chỉnh cho marker (đè status). | string | — |
active | Đánh dấu item đang hoạt động. | boolean | false |
dot | Custom dot content | React.ReactNode | — |
collapsible | Make item collapsible | boolean | false |
expanded | Expanded state for collapsible | boolean | — |
onExpandChange | Callback when expanded state changes | (expanded: boolean) => void | — |
expandContent | Content to show when expanded | React.ReactNode | — |
badge | Custom badge/tag | React.ReactNode | — |
Hướng dẫn sử dụng
Dùng Timeline để trình bày dữ liệu có cấu trúc dễ quét. Cần tiêu đề có nghĩa, thứ tự ổn định và hành vi responsive phù hợp với dữ liệu dày.
Trợ năng
Khi dùng Timeline, hãy giữ trạng thái focus dễ nhận biết, cung cấp tên truy cập khi cần và kiểm tra bàn phím cùng trình đọc màn hình trong ngữ cảnh thực tế.