Thành phần giao diện Ark UI & Tailwind CSS v4

ArkToggle Component

Nút bật/tắt đơn lẻ (toggle button) được xây dựng trên nền tảng @ark-ui/react/toggle và hệ thống thiết kế Tailwind CSS v4. Hỗ trợ 4 kích thước (xs/sm/md/lg) đồng bộ với Input & Button, 4 biến thể giao diện, chế độ icon-only và Compound Anatomy.

1. Cơ bản: Shorthand API

Shorthand

Sử dụng <ArkToggle> với icon, children và defaultPressed. Click để bật/tắt.

2. Bộ sưu tập 4 Biến thể Giao diện

Chuyển đổi giữa các kiểu dáng: default, outline, subtle, ghost.

3. Kích thước (xs / sm / md / lg)

Size Sync

Đồng bộ kích thước với Input và Button thông qua hệ thống --control-height tokens.

Kích thước:

4. Đồng bộ kích thước với Input và Button (Input & Button Sync)

Pixel Perfect

Trực quan hoá sự đồng nhất tuyệt đối về chiều cao và kích thước icon giữa Input, ArkToggle (có text & icon-only) và Button ở cả 4 kích thước: xs, sm, md, lg.

XS (24px / 1.5rem)var(--spacing-control-height-xs)
SM (28px / 1.75rem)var(--spacing-control-height-sm)
MD (34px / 2.125rem)var(--spacing-control-height-md)
LG (40px / 2.5rem)var(--spacing-control-height-lg)

5. Trạng thái Controlled & onPressedChange

Controlled

Quản lý trạng thái bật/tắt bằng state bên ngoài. Nhận callback khi thay đổi.

Trạng thái:Đang phát

6. Toggle Indicator (Nội dung thay đổi theo trạng thái)

Compound

Sử dụng <ArkToggle.Indicator> để render nội dung khác nhau khi bật/tắt.

7. Thanh công cụ Icon-Only

Toolbar

Kết hợp nhiều toggle icon-only tạo thành thanh định dạng văn bản.

outline
subtle

8. Trạng thái Disabled

Toggle bị vô hiệu hoá. Không thể click, opacity giảm, cursor thay đổi.

9. Ví dụ thực tế: Thẻ Bài viết

Real-world

Sử dụng ArkToggle trong ngữ cảnh thực tế – ghim bài viết, yêu thích và đánh dấu.

Hướng dẫn tích hợp Ark UI với Tailwind CSS v4

Bài viết chi tiết về cách xây dựng các thành phần giao diện headless kết hợp hệ thống design token nhất quán. Bao gồm ToggleGroup, Toggle, Tabs và nhiều thành phần khác.

23/09/2026•5 phút đọc

10. Bảng thuộc tính API của ArkToggle

Danh sách các props chính để cấu hình thành phần ArkToggle.

Thuộc tínhKiểu dữ liệuMặc địnhMô tả
size'xs' | 'sm' | 'md' | 'lg''md'Kích thước đồng bộ với Input & Button (--control-height tokens).
variant'default' | 'outline' | 'subtle' | 'ghost''default'Phong cách giao diện khi bật/tắt.
iconReactNodeundefinedIcon hiển thị trước nội dung, tự động co theo --control-icon-size.
iconOnlybooleanfalseRender nút vuông (chiều rộng = chiều cao), bỏ padding ngang.
pressed / defaultPressedbooleanundefinedTrạng thái bật/tắt (Controlled / Uncontrolled).
onPressedChange(details: { pressed: boolean }) => voidundefinedCallback khi trạng thái bật/tắt thay đổi.
disabledbooleanfalseVô hiệu hoá toggle, ngăn click và giảm opacity.
© 2026. FlatVn All rights reserved. Version 4.4.2