Ark Accordion
Thành phần hiển thị danh sách các mục có thể thu gọn / mở rộng linh hoạt, xây dựng trên nền tảng State Machine Zag.js. Hỗ trợ animation chiều cao 100% bằng CSS Keyframes mượt mà, điều hướng bàn phím đầy đủ theo chuẩn WAI-ARIA và hỗ trợ cả Shorthand API lẫn Compound Components.
1. Phương thức sử dụng: Shorthand API vs Compound Components
Hai phong cách APIArkAccordion hỗ trợ cả cú pháp 1 dòng tiện ích (truyền mảng items) lẫn cấu trúc Compound Components để tùy biến sâu.
Truyền mảng items trực tiếp. Mỗi item hỗ trợ title, description, icon, badge và content.
ChillCMS tích hợp kiến trúc Server-Side Rendering thông qua React Router v7, phân tách bundle thông minh và asset caching đa tầng với Redis và CDN Cloudflare.
Mô hình CASL Ability với chính sách typed ownership code-owned tại app/config/permission/ownership.ts cho phép bảo vệ chặt chẽ các aggregate mutations.
Background jobs được quản lý độc lập với worker pool, tự động phục hồi khi gặp sự cố, kèm giao diện giám sát Bull-Board bảo vệ an toàn.
<ArkAccordion
variant="card"
defaultValue={['item-1']}
items={items}
/>Dùng ArkAccordion.Root, .Item, .ItemTrigger, .ItemContent để làm chủ layout 100%.
pnpm db:migrate, pnpm tokens:check.<ArkAccordion.Root variant="separated">
<ArkAccordion.Item value="1">
<ArkAccordion.Trigger icon={<Icon />}>
Tiêu đề
</ArkAccordion.Trigger>
<ArkAccordion.Content>
Nội dung
</ArkAccordion.Content>
</ArkAccordion.Item>
</ArkAccordion.Root>2. Ma trận kiểu dáng (Variants Matrix)
6 Variants6 kiểu dáng giao diện phong phú, đáp ứng từ các trang FAQ, Card cài đặt đến danh sách tác vụ độc lập.
3. Bốn kích thước tiêu chuẩn (Control Sizes)
xs | sm | md | lgĐồng bộ chính xác với ControlSize của ChillCMS (Button, Input, Switch, Badge), đảm bảo căn chỉnh thẳng hàng hoàn hảo.
Khoảng cách padding, độ cao tối thiểu của dòng tiêu đề (min-height), kích thước chữ và biểu tượng chevron indicator đều tự động co giãn theo giá trị md.
4. Chế độ mở: Đơn lẻ (Single) vs Đồng thời (Multiple)
multiple & collapsibleCấu hình cho phép chỉ mở một mục duy nhất (kiểu FAQ truyền thống) hoặc mở nhiều mục cùng lúc tùy nhu cầu trải nghiệm.
collapsible: true)pnpm db:migrate --name migration_name, đảm bảo không bị treo tiến trình hoặc giữ advisory lock database.5. Điều khiển trạng thái theo ý muốn (Controlled State)
Controlled APIKiểm soát danh sách các mục mở/đóng hoàn toàn bằng React State thông qua prop value và onValueChange.
6. Các ca sử dụng thực tế (Real-World Use Cases)
Rich UIMô hình kết hợp linh hoạt giữa Accordion và các components khác như Switch, Form Fields, Timeline và Badges.
Bảng cài đặt hệ thống (Settings Accordion)
Đã kết nối webhook cổng thanh toán PayOS và Stripe Checkout an toàn.
Lịch trình đơn hàng (Order History)
7. Tùy biến chỉ báo đóng/mở (Custom Indicators)
Custom SlotsCó thể thay thế biểu tượng mũi tên Chevron mặc định bằng dấu Cộng/Trừ (+ / -), biểu tượng mũi tên ngang hoặc ẩn chỉ báo.
ArkAccordion.ItemContext để nhận biết trạng thái expanded và render icon tùy ý mà không cần rotate mặc định.group-data-[state=open] của trigger để tạo bất kỳ hiệu ứng chuyển đổi nào mong muốn.