Giao diện
Khoảng 10 phút. Làm xong, app của bạn mang màu thương hiệu riêng, có chế độ tối và các thẻ số liệu xếp gọn bằng class Tailwind.
Màn hình dựng bằng antd và pro-components, sắp xếp bằng class Tailwind trong className, màu và bo góc lấy từ theme của app trong app/theme.tsx.
App không có file CSS. Có ba chỗ để chỉnh giao diện, theo thứ tự nên dùng: theme của app, component antd và prop của nó, rồi class Tailwind cho bố cục.
Component
Mỗi việc trên màn hình đã có component sẵn. Bảng dữ liệu dùng ProTable, chi tiết bản ghi dùng ProDescriptions, form trong hộp thoại dùng ModalForm hoặc DrawerForm. Số liệu tổng dùng StatisticCard, biểu đồ lấy từ @ant-design/charts, khung chat AI từ @ant-design/x. Icon lấy từ @ant-design/icons.
Thư viện giao diện khác không có trong app: MUI, shadcn, Chakra, styled-components, daisyUI. check báo lỗi khi gặp import của chúng.
Theme của app
app/theme.tsx giữ màu chính, bo góc, độ dày đặc, chế độ tối và bộ icon. Chủ app sửa ở Cài đặt › Giao diện app trong không gian làm việc, có xem trước; agent sửa thẳng file.
export const APP_THEME = /* ft-theme */ {
"colorPrimary": "#0f766e",
"borderRadius": 8,
"compact": false,
"dark": false,
"icons": "antd"
} /* /ft-theme */;- Giữ hai dấu
ft-themevà JSON hợp lệ: trang cài đặt đọc và ghi phần nằm giữa. - Chọn màu chính để chữ trắng trên nút vẫn đọc rõ, ví dụ
#1d4ed8,#0f766e,#be123c. - Mọi token khác của antd (font, chiều cao ô nhập, màu đầu bảng) đặt trong
APP_THEME.antd = { token, components }, cùng dạng với trình chỉnh theme của antd. Tên token sai bị cảnh báotheme.unknown-token. icons: "lucide"đổi mọi icon antd sang nét mảnh. Code vẫn viết tên icon antd.
Không bọc trang trong ConfigProvider theme riêng để đổi màu. Đổi APP_THEME, cả app đổi theo.
Màu trong component
Màu, viền và bóng lấy từ token, không viết mã màu cứng. style={{}} vẫn dùng được cho kích thước và bố cục mà antd không có prop.
import { theme } from "antd";
export function StatBadge({ value }: { value: number }) {
const { token } = theme.useToken();
return (
<span style={{ background: token.colorPrimaryBg, color: token.colorPrimary, padding: "2px 8px", borderRadius: token.borderRadiusSM }}>
{value}
</span>
);
}Mã màu cứng trong style bị cảnh báo code.hardcoded-color.
Class Tailwind
Viết class tiện ích Tailwind thẳng trong className: bố cục, khoảng cách, kích thước, responsive (md:), trạng thái (hover:). manh.run tự biên dịch các class có trong file .tsx, bản chạy thử và bản deploy dùng cùng một CSS.
import { ShoppingOutlined } from "@ant-design/icons";
export default function HomePage() {
return (
<div className="bg-layout min-h-screen p-6">
<div className="bg-surface border border-line-secondary rounded-ant-lg p-4 flex items-center gap-3">
<span className="size-9 rounded-ant bg-primary-soft text-primary flex items-center justify-center"><ShoppingOutlined /></span>
<div>
<div className="text-fg font-medium">Đơn mới</div>
<div className="text-fg-secondary text-sm">12 đơn chờ xác nhận</div>
</div>
</div>
</div>
);
}Các class màu dưới đây theo theme và tự đổi ở chế độ tối:
- Nền:
bg-surface(thẻ),bg-layout(trang),bg-elevated,bg-fill,bg-fill-strong. - Chữ:
text-fg,text-fg-secondary,text-fg-tertiary. Viền:border-line,border-line-secondary. - Màu trạng thái:
primary,success,warning,error,info, thêm hậu tố-softcho nền nhạt. - Bo góc:
rounded-ant-sm,rounded-ant,rounded-ant-lg. Font:font-sans,font-mono.
Thứ tự ưu tiên: class thắng style sẵn của antd trên cùng phần tử, style={{}} thắng class.
Cần biết
- Không có
import "tailwindcss", plugin,@applyhay file.css(code.no-tailwind-import,code.no-css-import). bg-white,text-gray-500,border-slate-200vẫn sáng ở chế độ tối,checkcảnh báocode.tw-hardcoded-neutral. Dùng class theo theme ở trên.- Tailwind không reset style mặc định của trình duyệt, nên
<button>tự viết giữ font của trình duyệt. DùngButtoncủa antd hoặc thêm[font-family:inherit]. - Dùng class để sắp xếp component antd, không dựng lại bảng, form hay hộp thoại bằng
div.
Bước tiếp theo
- Gọi API từ giao diện — đổ dữ liệu thật vào các màn hình vừa dựng.
- Chọn component theo việc — việc nào trên màn hình dùng component nào.
- theme.tsx — mọi khoá của
APP_THEME.