Ant Design (antd) là gì? Cài đặt, theme, antd React 2026

Trả lời nhanh: Ant Design (antd) là thư viện giao diện mã nguồn mở (MIT) cho React do Ant Group phát triển, mạnh ở trang quản trị doanh nghiệp. Bản mới nhất trên npm là 6.7.0 (04/11/2026), cần React 18 trở lên. Bạn cài bằng lệnh npm install antd.

Điểm chính

  • antd cung cấp sẵn component cho biểu mẫu, bảng dữ liệu, hộp thoại, menu, chọn ngày và thông báo.
  • Dòng 6.x là bản chính từ 21/11/2025. Dòng 5.x chỉ còn nhận bản vá lỗi nghiêm trọng.
  • Giao diện tuỳ biến qua design token và ConfigProvider. Dark mode chỉ cần đổi thuật toán màu.
  • Tiếng Việt có sẵn qua locale vi_VN.
  • Ant Design Pro là bộ khung ứng dụng quản trị dựng trên antd. ProComponents bản 3.x cho antd 6 vẫn đang beta.
Mục lục
  1. Ant Design (antd) là gì?
  2. Phiên bản antd hiện hành là bao nhiêu?
  3. Bộ component antd cho React gồm những gì?
  4. Cài đặt antd vào dự án React thế nào?
  5. Design token là gì và tuỳ biến theme antd bằng ConfigProvider ra sao?
  6. Bật dark mode trong antd như thế nào?
  7. Dùng tiếng Việt cho antd với locale vi_VN
  8. Ant Design Pro và ProComponents khác antd thế nào?
  9. Ưu và nhược điểm của antd
  10. So sánh antd với MUI, Chakra UI và shadcn/ui
  11. Lưu ý bảo mật khi dùng antd trong dự án thật
  12. Câu hỏi thường gặp

Ant Design (antd) là gì?

Ant Design là một hệ thống thiết kế (design system) do đội ngũ thiết kế của Ant Group, công ty công nghệ tài chính liên kết với Alibaba, xây dựng. Hệ thống này gồm nguyên tắc thiết kế, bảng màu, lưới bố cục và bộ thư viện component.

antd là tên gói npm của thư viện Ant Design cho React. Trong công việc hằng ngày, hai tên thường được dùng thay cho nhau.

Điểm khác biệt của antd là hướng tới ứng dụng doanh nghiệp (enterprise). Đó là các màn hình nhiều dữ liệu: bảng danh sách đơn hàng, biểu mẫu nhập hồ sơ, bộ lọc, cây phân quyền, trang báo cáo. Những hệ thống như phần mềm ERP, CRM hay trang quản trị nội bộ là nơi antd được dùng nhiều nhất.

Một số đặc điểm chính của antd:

  • Viết bằng TypeScript, có sẵn định nghĩa kiểu cho mọi component.
  • Giấy phép MIT, dùng được cho dự án thương mại.
  • Dùng CSS-in-JS qua gói @ant-design/cssinjs, không cần nhập file CSS riêng.
  • Hỗ trợ quốc tế hoá (i18n), có tiếng Việt, và bố cục từ phải sang trái (RTL).

Phiên bản antd hiện hành là bao nhiêu?

Theo trang gói antd trên npm, tại thời điểm 06/11/2026, nhãn latest trỏ tới bản 6.7.0, phát hành ngày 04/11/2026. Các dòng phiên bản cần biết:

Dòng Bản mới nhất trên npm Tình trạng
6.x 6.7.0 Bản chính, ra mắt 6.0.0 ngày 21/11/2025, đang được phát triển tính năng
5.x 5.29.3 Chuyển sang nhánh v5.x-stable, bảo trì một năm, chỉ vá lỗi nghiêm trọng
4.x 4.24.16 Đã ngừng phát triển, chỉ nên dùng cho dự án cũ

antd ra bản nhỏ khá dày. Vì vậy con số 6.7.0 có thể đã tăng khi bạn đọc bài này. Cách kiểm tra nhanh nhất là chạy npm view antd version trong terminal.

antd 6 có gì mới so với antd 5?

Theo thông báo phát hành chính thức của nhóm Ant Design, antd 6 có các thay đổi đáng chú ý sau:

  • Yêu cầu React 18 trở lên. Mã tương thích cho React cũ đã bị gỡ. Nhóm phát triển khuyến nghị React 19.
  • Bỏ hỗ trợ Internet Explorer.
  • CSS Variables là mặc định. Đổi theme lúc chạy nhẹ hơn. Có thêm tuỳ chọn zeroRuntime để sinh CSS tĩnh.
  • Cấu trúc DOM ngữ nghĩa. Mọi component nhận thuộc tính classNames và styles để chỉnh từng phần bên trong, ví dụ phần header và body của Card.
  • Component mới và cải tiến: Masonry cho bố cục dạng lưới so le, Drawer kéo đổi kích thước, InputNumber có kiểu nút tăng giảm, lớp phủ (mask) mặc định làm mờ nền.

Theo nhóm phát triển, nâng từ v5 lên v6 không cần codemod, chỉ cần sửa API cũ theo cảnh báo trong console. Dự án lớn vẫn nên chạy thử mọi màn hình trước.

Bộ component antd cho React gồm những gì?

antd chia component thành các nhóm theo công dụng. Bảng dưới liệt kê những component bạn sẽ gặp nhiều nhất khi làm trang quản trị.

Nhóm Component tiêu biểu Dùng để làm gì
Chung Button, Typography, Icon (gói @ant-design/icons) Nút bấm, tiêu đề, đoạn văn, biểu tượng
Bố cục Layout, Grid (Row, Col), Flex, Space, Masonry Chia khung trang, căn lề, xếp lưới
Điều hướng Menu, Breadcrumb, Tabs, Pagination, Steps Thanh menu bên, đường dẫn, phân trang
Nhập liệu Form, Input, Select, DatePicker, Upload, TreeSelect Biểu mẫu và kiểm tra dữ liệu
Hiển thị dữ liệu Table, Tree, Descriptions, Card, Tag, Statistic Bảng, cây, thẻ thông tin, số liệu
Phản hồi Modal, Drawer, message, notification, Popconfirm, Spin Hộp thoại, thông báo, trạng thái chờ

Form: biểu mẫu có sẵn kiểm tra dữ liệu

Form là component mạnh nhất của antd. Mỗi trường đặt trong Form.Item với thuộc tính name. Quy tắc kiểm tra (rules) khai báo ngay tại trường. Bạn không cần tự viết state cho từng ô nhập.

import { Form, Input, Button } from 'antd';

export default function ContactForm() {
  const [form] = Form.useForm();
  return (
    <Form form={form} layout="vertical" onFinish={(values) => console.log(values)}>
      <Form.Item label="Email" name="email" rules={[{ required: true, type: 'email' }]}>
        <Input />
      </Form.Item>
      <Button type="primary" htmlType="submit">Gửi</Button>
    </Form>
  );
}

Table: bảng dữ liệu có sắp xếp, lọc, phân trang

Table nhận hai thứ chính: columns mô tả các cột, dataSource là mảng dữ liệu. Dữ liệu thường lấy từ API của máy chủ.

const columns = [
  { title: 'Họ tên', dataIndex: 'name', key: 'name', sorter: true },
  { title: 'Phòng ban', dataIndex: 'dept', key: 'dept' },
];

<Table rowKey="id" columns={columns} dataSource={rows} pagination={{ pageSize: 10 }} />

Table còn hỗ trợ lọc, chọn nhiều dòng, cố định cột và cuộn ảo (virtual). Với bảng lớn, nên phân trang phía máy chủ.

Modal và các thông báo

Modal hiển thị hộp thoại, bật tắt bằng thuộc tính open (bản 4 dùng visible). Để Modal.confirm, message nhận đúng theme và ngôn ngữ, hãy bọc ứng dụng trong component App và gọi qua hook App.useApp().

Cài đặt antd vào dự án React thế nào?

Bạn cần Node.js và một dự án React 18 hoặc 19. Các bước sau dùng Vite làm ví dụ minh hoạ. Với Create React App hay dự án sẵn có, bỏ qua bước 1.

  1. Tạo dự án mới: npm create vite@latest my-app, chọn React và TypeScript.
  2. Vào thư mục dự án và cài antd: npm install antd.
  3. Nếu cần biểu tượng, cài thêm: npm install @ant-design/icons.
  4. Nhập component và dùng ngay. Không cần nhập file CSS.
  5. Chạy npm run dev và mở trình duyệt để xem kết quả.
import { Button, DatePicker, Space } from 'antd';

export default function App() {
  return (
    <Space>
      <Button type="primary">Lưu</Button>
      <DatePicker />
    </Space>
  );
}

antd hỗ trợ tree shaking qua module ES. Công cụ build chỉ đóng gói component bạn thật sự nhập. Bạn không cần plugin babel-plugin-import như thời antd 3.

Dùng antd với Next.js

Với Next.js App Router, style CSS-in-JS cần thu gom phía máy chủ để trang không bị nháy khi tải. Nhóm Ant Design cung cấp gói @ant-design/nextjs-registry (bản 1.3.0 trên npm) cho việc này. Bạn bọc layout gốc bằng AntdRegistry. Các component có tương tác như Form, Modal vẫn phải nằm trong client component.

Design token là gì và tuỳ biến theme antd bằng ConfigProvider ra sao?

Design token là các biến thiết kế có tên, ví dụ màu chính, bo góc, cỡ chữ. Thay vì sửa CSS của từng nút, bạn đổi giá trị token. Mọi component dùng token đó sẽ đổi theo.

antd chia token thành ba tầng:

  • Seed token: giá trị gốc như colorPrimary, colorSuccess, colorError, borderRadius, fontSize, fontFamily.
  • Map token: sinh ra từ seed token bằng thuật toán, ví dụ dải 10 sắc độ của màu chính.
  • Alias token: token dùng cho mục đích cụ thể, ví dụ màu nền hộp nổi colorBgElevated, chiều cao ô nhập controlHeight.

Bạn truyền token qua thuộc tính theme của ConfigProvider. ConfigProvider bọc ở gốc ứng dụng, mọi component bên trong nhận cùng cấu hình.

import { ConfigProvider } from 'antd';

<ConfigProvider
  theme={{
    token: { colorPrimary: '#1a56db', borderRadius: 8, fontFamily: 'Roboto, sans-serif' },
    components: {
      Button: { controlHeight: 40 },
      Table: { headerBg: '#eff6ff' },
    },
  }}
>
  <App />
</ConfigProvider>

Phần token đổi giao diện toàn cục. Phần components ghi đè riêng cho từng loại component. Danh sách token của mỗi component nằm ở cuối trang tài liệu của component đó trên ant.design.

Thường chỉ cần đặt colorPrimary, antd tự sinh màu khi rê chuột, khi bấm và màu nền nhạt. ConfigProvider lồng nhau được, nên một khu vực có thể dùng màu riêng. Trong component tự viết, gọi theme.useToken() để lấy giá trị token.

Tránh ghi đè trực tiếp các class nội bộ dạng .ant-btn trong CSS. Tên class và cấu trúc DOM đã thay đổi ở antd 6. Cách này dễ vỡ khi nâng cấp. Ưu tiên token, rồi mới tới classNames và styles.

Bật dark mode trong antd như thế nào?

antd có sẵn ba thuật toán màu: theme.defaultAlgorithm (sáng), theme.darkAlgorithm (tối) và theme.compactAlgorithm (thu gọn khoảng cách). Bật dark mode chỉ là đổi thuật toán.

import { useState } from 'react';
import { ConfigProvider, Switch, theme } from 'antd';

export default function Root() {
  const [dark, setDark] = useState(false);
  return (
    <ConfigProvider theme={{ algorithm: dark ? theme.darkAlgorithm : theme.defaultAlgorithm }}>
      <Switch checked={dark} onChange={setDark} />
    </ConfigProvider>
  );
}

Bạn có thể kết hợp nhiều thuật toán trong một mảng, ví dụ algorithm: [theme.darkAlgorithm, theme.compactAlgorithm] để có giao diện tối và gọn. Màu chính đặt trong token vẫn được giữ, antd tự điều chỉnh sắc độ cho nền tối.

Thuật toán chỉ đổi màu component antd. Phần bạn tự viết cần lấy màu từ theme.useToken(), nếu không sẽ còn mảng trắng trên nền tối. Muốn theo chế độ của hệ điều hành, đọc media query prefers-color-scheme rồi gán vào state dark.

Dùng tiếng Việt cho antd với locale vi_VN

Mặc định antd hiển thị tiếng Anh. Các chuỗi có sẵn như “Cancel”, “OK”, “No data”, “Select date” sẽ xuất hiện trong Modal, Pagination, Table, DatePicker. Theo trang tài liệu quốc tế hoá của antd, tiếng Việt có mã vi_VN trong danh sách ngôn ngữ hỗ trợ.

import { ConfigProvider } from 'antd';
import viVN from 'antd/locale/vi_VN';
import dayjs from 'dayjs';
import 'dayjs/locale/vi';

dayjs.locale('vi');

<ConfigProvider locale={viVN}>
  <App />
</ConfigProvider>

Có hai phần cần làm cùng lúc:

  1. Truyền viVN vào ConfigProvider để dịch chuỗi của component.
  2. Đặt locale cho thư viện ngày giờ dayjs, mà DatePicker dùng bên dưới, để tên thứ và tháng hiện tiếng Việt.

Locale chỉ dịch chuỗi của antd. Nhãn và thông báo lỗi bạn tự viết vẫn cần thư viện i18n riêng nếu ứng dụng đa ngôn ngữ. Chuỗi nào chưa có bản dịch sẽ hiện tiếng Anh, bạn có thể ghi đè khoá đó.

Ant Design Pro và ProComponents khác antd thế nào?

Ba cái tên này hay bị dùng lẫn. Thực ra chúng là ba lớp chồng lên nhau, mỗi lớp dựng trên lớp dưới.

Sơ đồ các lớp trong hệ sinh thái Ant Design, từ trên xuống: Ant Design Pro là bộ khung ứng dụng quản trị; ProComponents là component cấp cao
Sơ đồ minh hoạ: mỗi lớp dựng trên lớp bên dưới. Bạn có thể chỉ dùng antd mà không cần ProComponents hay Ant Design Pro.

ProComponents

ProComponents (gói @ant-design/pro-components) là bộ component cấp cao. Mỗi component gói nhiều thứ thường đi cùng nhau:

  • ProLayout: khung trang quản trị gồm menu bên, thanh trên, breadcrumb.
  • ProTable: Table kèm ô tìm kiếm, bộ lọc, thanh công cụ, tự gọi hàm lấy dữ liệu và phân trang.
  • ProForm: Form với các trường dựng sẵn, biểu mẫu nhiều bước, biểu mẫu trong Modal hoặc Drawer.

Điểm cần biết về phiên bản: trên npm, bản ổn định mới nhất của ProComponents là 2.8.10, chỉ hỗ trợ antd 4 và antd 5. Dòng 3.x hỗ trợ antd 6 vẫn mang nhãn beta (bản 3.1.15-9 phát hành 01/11/2026). Nếu dự án cần ProTable ở mức ổn định cho production, bạn cân nhắc giữ antd 5 thêm một thời gian, hoặc chấp nhận dùng bản beta và kiểm thử kỹ.

Ant Design Pro

Ant Design Pro là một dự án mẫu (boilerplate) hoàn chỉnh cho ứng dụng doanh nghiệp. Bản v6 trên GitHub dùng React 19, Umi Max 4, antd 6, ProComponents 3 và Tailwind CSS v4 kết hợp antd-style. Dự án có sẵn:

  • Trang đăng nhập, đăng ký, trung tâm tài khoản.
  • Các mẫu dashboard phân tích, giám sát, bàn làm việc.
  • Mẫu biểu mẫu cơ bản, nhiều bước, nâng cao; danh sách dạng bảng, dạng thẻ.
  • Giải pháp i18n, dữ liệu giả (mock) để làm giao diện trước khi có backend, và kiểm thử.

Cách bắt đầu: sao chép kho ant-design-pro từ GitHub về máy, chạy npm install, rồi npm start. Lệnh npm run simple xoá bớt trang mẫu và dữ liệu giả. Theo tài liệu dự án, thao tác này không hoàn tác được, nên chạy ngay từ đầu.

Ant Design Pro hợp khi làm hệ thống quản trị mới và chấp nhận cách tổ chức của Umi. Dự án Vite hoặc Next.js sẵn có thường chỉ cần antd cộng vài component ProComponents.

Ưu và nhược điểm của antd

Ưu điểm

  • Đủ component cho màn hình nhiều dữ liệu. Table, Tree, Transfer, Cascader, TreeSelect, Upload đều có sẵn và miễn phí. Nhiều thư viện khác phải ghép thêm hoặc trả phí cho tính năng tương đương.
  • Form mạnh. Kiểm tra dữ liệu, trường động, liên kết giữa các trường được thiết kế sẵn.
  • Theme bằng token. Đổi màu thương hiệu, dark mode, giao diện gọn chỉ cần vài dòng cấu hình.
  • TypeScript đầy đủ và hệ sinh thái lớn: ProComponents, Ant Design Pro, bộ biểu tượng.

Nhược điểm

  • Giao diện dễ nhận ra. Nếu không tuỳ biến, sản phẩm của bạn trông giống hàng nghìn trang quản trị khác. Muốn khác hẳn thì tốn công.
  • Nặng hơn thư viện tối giản. Dùng nhiều component phức tạp như Table, DatePicker làm tăng dung lượng bundle. Hợp với ứng dụng nội bộ hơn trang công khai cần tải cực nhanh.
  • CSS-in-JS có chi phí lúc chạy và cần cấu hình thêm khi render phía máy chủ, dù antd 6 đã giảm nhờ CSS variables.
  • Đổi API giữa các bản lớn. Ví dụ visible thành open, Menu chuyển sang thuộc tính items. Dự án lâu năm thường phải sửa nhiều chỗ khi nâng cấp.
  • Một phần thảo luận bằng tiếng Trung trên GitHub issue.

So sánh antd với MUI, Chakra UI và shadcn/ui

Số phiên bản dưới đây lấy từ npm ngày 06/11/2026.

Tiêu chí antd MUI Chakra UI shadcn/ui
Bản trên npm antd 6.7.0 @mui/material 9.5.0 @chakra-ui/react 3.38.0 CLI shadcn 4.23.0
Ngôn ngữ thiết kế Ant Design, thiên về doanh nghiệp Material Design của Google Trung tính, dễ chỉnh Tối giản, bạn tự định hình
Cách dùng Cài gói npm Cài gói npm Cài gói npm CLI chép mã component vào dự án của bạn
Cách tạo style CSS-in-JS, design token, CSS variables Emotion (cần @emotion/react) Emotion, hệ token và recipe Tailwind CSS
Bảng dữ liệu nâng cao Table miễn phí, đủ tính năng phổ biến DataGrid thuộc MUI X, bản Pro và Premium trả phí Table cơ bản Mẫu Table, thường ghép với TanStack Table
Hợp nhất với Trang quản trị, ERP, CRM Ứng dụng theo Material, cả web công khai Sản phẩm cần giao diện riêng, gọn Sản phẩm dùng Tailwind, cần kiểm soát từng chi tiết

Cách chọn ngắn gọn theo tình huống:

  • Màn hình chủ yếu là bảng, biểu mẫu, bộ lọc, cần xong nhanh: chọn antd.
  • Đội đã quen Material Design hoặc sản phẩm cần giống ứng dụng Android: chọn MUI.
  • Cần giao diện riêng nhưng vẫn muốn component dựng sẵn và theme rõ ràng: chọn Chakra UI.
  • Dự án đã dùng Tailwind và muốn sở hữu toàn bộ mã giao diện: chọn shadcn/ui. Đổi lại, bạn tự bảo trì phần mã đã chép.

Lưu ý bảo mật khi dùng antd trong dự án thật

antd là gói npm có rất nhiều phụ thuộc. Gói 6.7.0 kéo theo hàng chục gói con trong nhóm @rc-component và @ant-design. Vì vậy chuỗi cung ứng phần mềm cần được quản lý:

  • Khoá phiên bản bằng file lock (package-lock.json hoặc pnpm-lock.yaml) và cập nhật có kiểm soát. Tháng 12/2018, một số bản antd 3.x từng chứa đoạn mã ẩn (easter egg) phủ tuyết lên nút bấm dịp Giáng sinh, gây phản ứng lớn từ người dùng.
  • Kiểm tra đúng tên gói. Gói chính là antd, gói phụ nằm trong nhóm @ant-design. Gói tên na ná có thể là hàng giả chứa mã độc.
  • Không render HTML từ người dùng. Table, Descriptions, Modal hiển thị chuỗi an toàn vì React tự thoát ký tự. Rủi ro chỉ xuất hiện khi bạn dùng dangerouslySetInnerHTML trong hàm render của cột. Xem thêm về tấn công XSS để hiểu vì sao.
Tóm tắt nhanh: Ant Design (antd) là gì
Tóm tắt các ý chính của bài.

Câu hỏi thường gặp

antd có miễn phí cho dự án thương mại không?

Có. antd phát hành theo giấy phép MIT, bạn được dùng, sửa và bán sản phẩm có antd. Bạn chỉ cần giữ thông báo giấy phép đi kèm mã nguồn.

Có nên nâng từ antd 5 lên antd 6 ngay không?

Nếu dự án đã dùng React 18 hoặc 19 và không phụ thuộc nhiều vào ProComponents, bạn có thể nâng sau khi kiểm thử. Dòng 5.x chỉ còn nhận bản vá lỗi nghiêm trọng trong thời gian bảo trì một năm. Nếu dùng nhiều ProTable, ProForm, hãy theo dõi khi nào ProComponents 3.x ra bản ổn định.

antd có dùng được với React 17 không?

antd 6 yêu cầu React 18 trở lên. Dự án còn ở React 17 có thể dùng antd 5, nhưng nên lên kế hoạch nâng React vì dòng 5 đã bước vào giai đoạn chỉ bảo trì.

Ant Design Pro có bắt buộc phải dùng Umi không?

Bộ khung Ant Design Pro được xây trên Umi Max, nên dùng nó là dùng Umi. Nếu bạn muốn Vite hoặc Next.js, hãy cài antd và @ant-design/pro-components trực tiếp vào dự án, rồi tự dựng bố cục bằng ProLayout.