Skip to Content

Công thức trang

Cách ghép component cho các loại trang hay gặp như dashboard, danh sách, form dài, cài đặt, trang kết quả, theo bố cục của ant-design-pro, kèm các tên prop cũ cần thay.

Mỗi công thức là thứ tự các khối từ trên xuống. Chọn công thức gần với trang bạn cần nhất, rồi thay dữ liệu và chữ cho đúng nghiệp vụ. Ví dụ dưới đây là dashboard của chủ một cửa hàng, dựng theo công thức đầu tiên.

Dashboard điều hành (bán lẻ đa kênh)Dashboard của chủ cửa hàng nội thất 3 kênh: chọn kỳ (hôm nay / 7 ngày / tháng / 12 tháng) đổi mọi con số, 4 KPI có so sánh kỳ trước, biểu đồ doanh thu – lợi nhuận, tỷ trọng kênh, sản phẩm bán chạy, việc cần xử lý và tồn kho cảnh báo.
ví-dụ.manh.run · dữ liệu mẫuMở để sửa ↗
Ví dụ chạy khi bạn cuộn tới

Dashboard của người duyệt

Người duyệt mở app để biết còn bao nhiêu việc. Vì vậy việc cần làm nằm trên, số liệu nằm dưới.

PageContainer lời chào + số việc đang chờ └── StatRow 3 con số, mỗi số có dòng phụ └── Row gutter ├── Col lg={15} ProList: việc cần duyệt └── Col lg={9} biểu đồ cơ cấu

Dashboard phân tích

Chủ doanh nghiệp xem xu hướng theo kỳ và so sánh các nhóm.

Row 4 thẻ KPI: số lớn + biểu đồ nhỏ + chỉ số ở chân thẻ Card có tab doanh số / lượt xem, chọn khoảng thời gian ở tabBarExtraContent ├── Col xl={16} biểu đồ cột └── Col xl={8} bảng xếp hạng Row 2 thẻ rộng nửa trang: danh sách top, biểu đồ tròn có Segmented

Trang danh sách

PageContainer → ProTable (ô tìm kiếm, tab có số đếm, nút tạo ở toolBarRender, rowSelection kèm thao tác hàng loạt). Bấm một dòng thì mở trang chi tiết. Bản ghi ít trường thì mở Drawer size={600} chứa ProDescriptions. Xem thêm ở Trang danh sách.

Danh sách dạng thẻ

Danh mục sản phẩm, dự án: ProList grid={{ gutter: 16, column: 3 }} với metas gồm title, subTitle (Tag), avatar, description, content (tiến độ), actions.

Form dài nhiều phần

ProForm bọc toàn bộ nội dung PageContainer ├── ProCard mỗi phần một thẻ, 3 trường một hàng ├── EditableProTable các dòng hàng hoá └── FooterToolbar nút gửi + danh sách lỗi

Form nhiều bước

PageContainer → ProCard → StepsForm: điền thông tin → xác nhận (Descriptions + Alert) → Result status="success". Xem Form.

Trang cài đặt

Hai cột: bên trái Menu mode="inline" rộng 224px liệt kê các phần, bên phải một ProForm layout="vertical" cho phần đang chọn, chỉ có nút lưu.

app/settings/page.tsx
<Flex gap={24}> <Menu mode="inline" style={{ width: 224 }} selectedKeys={[section]} onClick={(e) => setSection(e.key)} items={SECTIONS} /> <ProForm layout="vertical" style={{ flex: 1 }} key={section} request={() => api.settings.list()} submitter={{ searchConfig: { submitText: "Lưu" }, resetButtonProps: false }} onFinish={async (v) => { await api.settings.put(v); message.success("Đã lưu"); return true; }}> {/* … các trường của phần đang chọn */} </ProForm> </Flex>

Trang kết quả và lỗi

Result status="success" | "error" | "403" | "404" | "500" kèm một nút chính, ví dụ Về danh sách. Đặt trong PageContainer để người dùng vẫn thấy menu.

Tên cũ cần thay

Ví dụ trên internet thường dùng tên prop cũ. Dùng tên bên phải mũi tên:

  • Card của antd: bordered → variant; bodyStyle / headStyle → styles={{ body, header }}. Riêng ProCard và StatisticCard 2.x vẫn dùng bodyStyle / bordered, nên ở đó giữ tên cũ.
  • Modal / Drawer: visible → open; destroyOnClose → destroyOnHidden (xem lưu ý về xoá dữ liệu cũ của form ở Form); width của Drawer → size.
  • Tabs.TabPane / Menu.Item viết bằng JSX → prop items.
  • Space direction → orientation, split → separator. Steps direction → orientation, items.description → items.content.
  • Statistic valueStyle → styles.content. Alert message → title. Dropdown.Button / Button.Group → Space.Compact.
  • Tên prop của pro-components v3 không có ở bản 2.8.10: dùng renderFormItem (không phải formItemRender); layout="mix" vẫn đúng.

Cần biết

  • Không chép createStyles, less hay className={styles.x} từ ant-design-pro. Dùng token + style inline, Grid.useBreakpoint() thay cho @media, chuỗi viết thẳng thay cho useIntl, useNavigate thay cho history của umi.
  • Xếp thẻ thành cột bằng Row gutter + Col, không dùng ProCard gutter vì thẻ sẽ thụt vào so với thẻ rộng ở trên và dưới.
  • List của antd không còn được khuyên dùng từ bản 6.4. Lưới thẻ viết mới thì dùng ProList hoặc Row / Col chứa ProCard.

Bước tiếp theo

Cập nhật