Giao diện
Primitive antdv re-export
Ngoài 17 component thương hiệu, @tasco/ui re-export một danh sách primitive của Ant Design Vue — những thứ không cần bọc thêm, chỉ cần một điểm import duy nhất.
ts
import { CSelect, CModal, CTabs } from '@tasco/ui'Vì sao không import thẳng từ ant-design-vue
- ESLint chặn (
no-restricted-imports) — kể cảimport type. - Đổi phiên bản antdv là việc của core: dự án không phải sửa import.
- Danh sách re-export là hợp đồng: component nào không có trong đó thì core chưa bảo đảm nó hợp với theme và mật độ của framework.
Cần một primitive chưa có trong danh sách: báo core để thêm, đừng import thẳng.
Sáu nhóm
| Nhóm | Gồm | Trang |
|---|---|---|
| Nhập liệu | CInput, CSelect, CDatePicker, CUpload… | Xem |
| Hiển thị dữ liệu | CDescriptions, CTabs, CBadge, CTree… | Xem |
| Bố cục | Row, Col, Space, Divider… | Xem |
| Phản hồi | CModal, CDrawer, CAlert, CSpin… | Xem |
| Điều hướng | CDropdown, CMenu, CBreadcrumb… | Xem |
| Gọi theo kiểu lệnh | message, notification | Xem |
Quy ước chung
- Tên: hầu hết có tiền tố
C; riêng nhóm bố cục (Row,Col,Space,Flex,Divider,Typography,Layout) giữ nguyên tên gốc. - Hành vi: giống hệt antdv — prop, slot, sự kiện không bị đổi. Tài liệu API đầy đủ ở antdv.org.
- Locale: layer đã truyền
vi_VNchoConfigProvider, nên phân trang, DatePicker, Modal, Popconfirm đều tiếng Việt sẵn. - Theme: màu và mật độ lấy từ
@tasco/theme; đừng ghi đè bằng CSS cục bộ khi chỉ cần một prop.
Liên quan
- Bộ component
C*— catalog đầy đủ. - Viết CSS trong dự án — quy tắc khi cần ghi đè.