Ark Tooltip
Thành phần Tooltip chú thích ngữ cảnh được phát triển dựa trên máy trạng thái của Ark UI (Zag.js engine) và tạo kiểu toàn diện với Tailwind CSS v4. Hỗ trợ chuẩn WAI-ARIA, tính toán vị trí thông minh với Floating UI, mũi tên định hướng đồng bộ màu sắc, chuyển cảnh mượt mà và cung cấp cả hai phong cách sử dụng: Cấp cao (Convenience API) và Ghép nối linh hoạt (Compound API).
1. Cơ bản (Basic Usage)
Sử dụng cú pháp tiện ích cấp cao để gắn tooltip vào bất kỳ phần tử nào khi hover hoặc focus.
2. Kích thước (Sizes)
Hỗ trợ 4 kích thước chuẩn từ siêu nhỏ gọn đến rộng rãi: xs, sm, md (mặc định) và lg.
3. Biến thể màu sắc & phong cách (Variants)
Đa dạng phong cách trực quan từ solid, subtle, outline, glass mờ ảo đến các màu ngữ cảnh primary, success, warning, error, info.
4. Vị trí hiển thị (Placements)
Lựa chọn 8 hướng neo vị trí khác nhau so với phần tử kích hoạt với cơ chế tránh va chạm viền màn hình tự động.
5. Mũi tên chỉ hướng (With & Without Arrow)
Tùy chọn hiển thị mũi tên định hướng (hasArrow: true/false) với đường viền và màu nền đồng bộ chính xác.
6. Độ trễ đóng mở (Custom Delays)
Tùy chỉnh thời gian chờ trước khi mở (openDelay) hoặc trước khi đóng (closeDelay) để tối ưu trải nghiệm.
7. Nội dung tương tác (Interactive Tooltip)
Cho phép người dùng rê chuột trực tiếp vào bên trong tooltip để click liên kết hoặc thao tác mà không bị tự đóng.
Nội dung tương tác được
Bạn có thể di chuột vào bên trong khung tooltip này để nhấn liên kết hoặc nút bấm.
8. Nội dung phong phú & Phím tắt (Rich Content)
Nhúng biểu tượng, tiêu đề phân cấp, mô tả phụ và phím tắt kbd trực quan bên trong tooltip.
Tự động đồng bộ với hệ thống lưu trữ đám mây
9. Điều khiển trạng thái (Controlled Mode)
Quản lý việc hiển thị tooltip từ bên ngoài thông qua React State với prop open và sự kiện onOpenChange.
10. Thanh công cụ chia sẻ Tooltip (Multiple Triggers)
Ark UI cho phép nhiều trigger dùng chung một instance Tooltip. Di chuyển qua lại mượt mà tức thì không bị chớp giật.
Di chuyển chuột giữa các nút trên thanh công cụ để trải nghiệm chuyển tiếp mượt mà không nhấp nháy:
11. Cấu trúc ghép nối (Compound Component API)
Sử dụng trực tiếp ArkTooltip.Root, ArkTooltip.Trigger, ArkTooltip.Positioner, ArkTooltip.Content để kiểm soát tối đa.
12. Tích hợp UI (Avatars, Badges, Disabled Elements)
Gắn tooltip cho hình đại diện, huy hiệu trạng thái, nút xóa nguy hiểm và nút bị disable (hỗ trợ accessibility).
13. Chạm trên mobile và click giữ mở
Trợ giúp gọn cạnh nhãn, click giữ mở sau hover và tooltip trên nút vẫn thực hiện hành động gốc.
Chạm hoặc click biểu tượng trợ giúp để giữ nội dung mở. Chạm lại, chạm bên ngoài, cuộn trang hoặc nhấn Escape để đóng.
Nội dung này giữ mở sau khi bạn rời chuột. Bạn có thể chạm vào nội dung để đọc, rồi chạm lại nút để đóng.
Với openOnClick, lần click đầu giữ mở cả khi tooltip đã xuất hiện do hover.
Số lần thực hiện: 0
Tooltip mặc định hỗ trợ chạm và vẫn giữ hành động của nút. Trên desktop, hover/focus hoạt động như bình thường.