Responsive Preview Component
Thành phần ResponsivePreview cung cấp khung xem trước giao diện trực quan đa kích thước (Desktop, Tablet, Mobile) tương tự như tính năng Preview nổi tiếng của Flowbite. Được tối ưu hóa trên nền tảng ArkFrame (sử dụng @ark-ui/react/frame), thành phần hỗ trợ cô lập CSS toàn diện, tự động đồng bộ Dark/Light theme, hướng viết LTR/RTL và cơ chế giao tiếp 2 chiều qua postMessage.
Chuyển đổi thiết bị mượt mà
Chuyển đổi tức thì giữa Desktop (100%), Tablet (768×1024) và Mobile (375×812) kèm hiệu ứng transition êm dịu và viền bezel chân thực.
Đồng bộ Dark / Light Mode
Một cú click trên thanh toolbar lập tức chuyển đổi màu sắc cả trang mẹ lẫn tài liệu con bên trong iframe mà không bị tải lại trang.
Hỗ trợ đầy đủ LTR & RTL
Kiểm tra khả năng hiển thị đa ngôn ngữ (tiếng Ả Rập, Do Thái) trực tiếp bằng nút gạt LTR / RTL với thuộc tính dir="rtl".
Giao tiếp postMessage 2 chiều
Gửi thông điệp sự kiện mỗi khi thay đổi cài đặt và khi frame load xong, tương thích với cả React components lẫn URL trang web ngoài.
1. Interactive Studio (Thử nghiệm toàn diện theo phong cách Flowbite)
Bấm vào các nút Desktop, Tablet, Mobile, nút LTR/RTL, Dark/Light mode trên toolbar để quan sát kích thước và giao diện phản hồi trực tiếp.
Flowbite Style Responsive Previewer
100% × Auto2. Chế độ xem trước Component với nút chuyển đổi Code & Preview
Tương tự tài liệu Flowbite hay Tailwind UI, bạn có thể truyền chuỗi mã nguồn qua prop code để người dùng xem mã và sao chép dễ dàng.
Thẻ thanh toán E-Commerce (Pricing Card)
768 × 10243. Hướng dẫn tích hợp Script vào trang con để đón nhận postMessage
Khi bạn nhúng một URL trang ngoài vào prop demoUrl, hãy đặt đoạn mã script nhỏ dưới đây vào trang con để tự động đồng bộ Dark Mode và LTR / RTL.
<script>
(function() {
function handleSync(event) {
if (!event.data || typeof event.data !== 'object') return;
var data = event.data;
if (data.type !== 'RESPONSIVE_PREVIEW_SYNC') return;
var html = document.documentElement;
// Cập nhật Theme (dark / light)
if (data.theme === 'dark') {
html.classList.add('dark');
html.style.colorScheme = 'dark';
} else if (data.theme === 'light') {
html.classList.remove('dark');
html.style.colorScheme = 'light';
}
// Cập nhật Hướng văn bản (ltr / rtl)
if (data.direction === 'rtl') {
html.setAttribute('dir', 'rtl');
} else if (data.direction === 'ltr') {
html.setAttribute('dir', 'ltr');
}
}
window.addEventListener('message', handleSync);
})();
</script>Mỗi khi người dùng ấn nút chuyển thiết bị, Dark/Light mode hoặc LTR/RTL trên Toolbar, ResponsivePreview sẽ gửi payload dạng:
{ type: 'RESPONSIVE_PREVIEW_SYNC', theme: 'dark', direction: 'rtl', device: 'mobile' }4. Cấu trúc linh hoạt với Compound Components (Root, Toolbar, Workspace, Frame)
Bạn có thể tự do bố trí lại Toolbar, thêm nút hành động riêng hoặc tùy biến khung workspace theo nhu cầu cụ thể.
Custom Toolbar Demo
768 × 1024Bảng thuộc tính & API Reference
| Thuộc tính | Kiểu dữ liệu (Type) | Mặc định | Mô tả |
|---|---|---|---|
| device | 'desktop' | 'tablet' | 'mobile' | 'desktop' | Kích thước thiết bị xem trước. |
| theme | 'light' | 'dark' | 'auto' | 'auto' | Chế độ giao diện sáng/tối đồng bộ vào frame. |
| direction | 'ltr' | 'rtl' | 'ltr' | Hướng văn bản Left-To-Right hoặc Right-To-Left. |
| orientation | 'portrait' | 'landscape' | 'portrait' | Xoay màn hình dọc/ngang cho Mobile và Tablet. |
| code | string | undefined | Mã nguồn component để hiển thị tab Code và nút Copy. |
| demoUrl / src | string | undefined | URL trang web nhúng vào iframe thay vì dùng React children. |
| showDimensions | boolean | true | Hiển thị badge độ phân giải thực tế (VD: 375 × 812). |
| showFullscreen | boolean | true | Nút mở rộng toàn bộ màn hình làm việc. |