Flowbite PatternArkFrame + Tailwind CSS v4postMessage Sync

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)

Core Feature

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

2. Chế độ xem trước Component với nút chuyển đổi Code & Preview

Preview & Code

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)

3. Hướng dẫn tích hợp Script vào trang con để đón nhận postMessage

postMessage Sync

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.

MÃ SCRIPT ĐẶT TẠI TRANG CON (CHILD PAGE IFRAME)
<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>
Cơ chế hoạt động của postMessage:

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)

Advanced API

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

Bảng thuộc tính & API Reference

Thuộc tínhKiểu dữ liệu (Type)Mặc địnhMô 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.
codestringundefinedMã nguồn component để hiển thị tab Code và nút Copy.
demoUrl / srcstringundefinedURL trang web nhúng vào iframe thay vì dùng React children.
showDimensionsbooleantrueHiển thị badge độ phân giải thực tế (VD: 375 × 812).
showFullscreenbooleantrueNút mở rộng toàn bộ màn hình làm việc.
© 2026. FlatVn All rights reserved. Version 4.4.2