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)
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.
2. Giả Lập Điện Thoại (Mobile Simulator - iPhone 16)
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.
Đặ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!
- • 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)
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.
4. Chế Độ Co Giãn Chiều Cao Tự Động (autoHeight Mode)
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).
5. So Sánh Song Song Sáng & Tối (Side-by-Side Theme Contrast)
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.
6. Tương Thích Hoàn Hảo Với Ark UI (@ark-ui/react/frame 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 định | Mô 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 |
| autoHeight | boolean | false | Tự động dãn/co chiều cao iframe theo nội dung bên trong |
| syncParentStyles | boolean | true | Tự động đồng bộ các thẻ <style> (Vite HMR) và stylesheet |
| showToolbar | boolean | false | Hiển thị thanh công cụ điều khiển tương tác nhanh trên đỉnh frame |