Ark UI + Tailwind CSS v4Isolated DOM IframeHMR & Theme SyncResponsive Shell Mockup

Ark Frame Component

Thành phần ArkFrame xây dựng trên nền tảng @ark-ui/react/frame kết hợp với hệ thống design token của Tailwind CSS v4. Thành phần cung cấp môi trường iframe cô lập hoàn toàn, tự động đồng bộ stylesheet dự án (bao gồm Vite HMR) và Dark/Light mode, giải quyết triệt để nhu cầu giả lập thiết bị di động (Mobile Simulator), khung trình duyệt (Browser Mockup), máy tính bảng (Tablet) và xem trước nội dung co giãn linh hoạt (Auto Height).

Cô lập CSS hoàn toàn

Styles bên trong không rò rỉ ra ngoài và ngược lại. Hoàn hảo để test media queries và components.

Đồng bộ Vite HMR & Theme

Theo dõi MutationObserver để cập nhật style tức thì khi dev và đồng bộ chế độ Dark/Light.

Mockup chuẩn thiết bị

Sẵn sàng khung iPhone 16 với Dynamic Island, iPad, Browser macOS, Windows Desktop.

Ark EnvironmentProvider

Các component Ark UI bên trong gắn Portal và đo tọa độ chính xác vào document của iframe.

1. Interactive Studio (Thử nghiệm tương tác đa năng)

Live Playground

Tùy biến trực tiếp biến thể khung, kiểu thiết bị, hướng xoay màn hình, theme cục bộ và tỷ lệ thu phóng.

Biến thể:
ChillCMS Studio Preview — https://chillcms.local/studio

2. Giả Lập Điện Thoại (Mobile Simulator - iPhone 16)

Phone Mockup

Mô phỏng chân thực iPhone 16 với Dynamic Island, thanh trạng thái (Status Bar: 9:41, 5G, pin), khung viền bo tròn 44px và thanh vuốt Home Indicator.

9:41
ChillPay
5G
99%

Đặc quyền của <ArkFrame variant="phone">

Khi kiểm tra layout responsive trên máy tính, cửa sổ trình duyệt thường rộng hơn 1000px. Với ArkFrame, bạn có thể kiểm định chính xác hành vi của các breakpoint < 768px (như padding di động, menu burger, bottom navigation bar) mà không cần resize cửa sổ trình duyệt của bạn!

Cấu hình tiêu chuẩn:
  • • Viền bezel: 10px slate-800/900
  • • Bo góc: rounded-[44px]
  • • Chiều rộng: 393px (iPhone 16)
  • • Dynamic Island pill linh hoạt

3. Khung Trình Duyệt macOS (Browser Window Mockup)

Browser Shell

Mô phỏng cửa sổ trình duyệt hiện đại với 3 nút điều khiển traffic lights, thanh địa chỉ SSL có khóa bảo mật và nút sao chép link.

ChillCMS Dashboard Analytics — https://app.chillcms.vn/analytics

4. Chế Độ Co Giãn Chiều Cao Tự Động (autoHeight Mode)

ResizeObserver --height

Ark Frame tự động đo lường kích thước nội dung và thiết lập CSS Custom Property --height. Không sinh thanh cuộn lồng nhau (nested scrollbar).

Số mục hiện tại: 3

5. So Sánh Song Song Sáng & Tối (Side-by-Side Theme Contrast)

theme='light' vs theme='dark'

Hiển thị đồng thời cùng một component ở cả 2 chế độ Light mode và Dark mode để kiểm tra độ tương phản màu sắc.

Giao diện Sáng (Force Light)
Giao diện Tối (Force Dark)

6. Tương Thích Hoàn Hảo Với Ark UI (@ark-ui/react/frame EnvironmentProvider)

EnvironmentProvider

Bên trong ArkFrame, các component Ark UI (như ArkSwitch, Form Control, Buttons) tự động nhận iframe document làm môi trường tính toán.

Tài Liệu API & Props Reference

Thuộc tính (Prop)Kiểu dữ liệu (Type)Mặc địnhMô tả chi tiết
variant'bare' | 'default' | 'card' | 'browser' | 'phone' | 'tablet' | 'window''default'Biến thể khung viền (Phone, Tablet, Browser window, v.v.)
device'auto' | 'responsive' | 'iphone-16' | 'iphone-se' | 'pixel-8' | 'ipad-mini' | 'ipad-pro' | 'laptop' | 'desktop''auto'Preset kích thước thiết bị phần cứng
orientation'portrait' | 'landscape''portrait'Hướng màn hình (Dọc / Ngang)
theme'auto' | 'light' | 'dark''auto'Đồng bộ theme cha hoặc cưỡng chế chế độ Sáng / Tối trong frame
autoHeightbooleanfalseTự động dãn/co chiều cao iframe theo nội dung bên trong
syncParentStylesbooleantrueTự động đồng bộ các thẻ <style> (Vite HMR) và stylesheet
showToolbarbooleanfalseHiển thị thanh công cụ điều khiển tương tác nhanh trên đỉnh frame
© 2026. FlatVn All rights reserved. Version 4.4.2