R后悔药 Rue.js
  • 首页
    • 深度指南
    • 实战例子
    • 快速上手
    • 路由指南
    • 术语表
    • 错误代码参考
  • API
    • 合作伙伴
    • 插件
    • 组件库
    • 工具链
    • Text.js
    • 新闻简报
    • 常见问题
    • 团队
    • 版本发布
    • 社区指南
    • 行为规范
    • 隐私政策
  • 赞助
  • 合作伙伴
设置
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window

Mockup Phone 手机外框

MockupPhone 可以使用 Rue 基础的 compound 结构,同时补上一层更顺手的根级 API:可以直接声明display、size、color和camera,在快速搭示例 时不用每次都手写完整骨架。

何时使用

  • 需要在设计页、营销页或功能介绍页展示移动端界面,而不想自己维护手机边框结构。
  • 需要在“快速搭一个手机画面”和“完全自定义显示区 DOM”之间自由切换。
  • 需要统一控制机身尺寸、边框主色、摄像头显隐和屏幕内容布局。

# 推荐写法

display 简写模式适合绝大多数展示型场景,根节点上就能把机身、摄像头和屏幕内容一次性声明完。

Rue OS
It's Glowtime.
根级 display API
mockup phone wallpaper
9:41
Today
3 meetings
Design sync, API review, launch checklist

# iPhone mockup

展示 compound 写法,适合你想显式控制摄像头和显示区结构的时候。

It's Glowtime.

# With color and wallpaper

基础壁纸示例 展示,同时说明 className 仍然是最高自由度的扩展入口。

wallpaper

# 尺寸与边框色

size 控制机身宽度,color 负责常用边框主题色;如果需要更细粒度样式,继续追加 className 即可。

XS
xs
Rue 示例
SM
sm
Rue 示例
MD
md
Rue 示例
LG
lg
Rue 示例

# 屏幕内容布局

display.contentClassName 适合把文案、状态块和浮层叠加到壁纸或纯色背景之上。

Recording14m left
Weekly launch
84%
Focus
2h 18m
Notes
保持 compound,同时用 display 简写快速搭状态屏。
Next
Ship Mockup Phone API

# 摄像头控制

camera 默认开启;当画面更偏卡片展示时可以关闭,或者通过对象写法补充类名和属性。

camera=
适合更像产品卡片的展示。
Custom camera
用对象写法继续给摄像头节点补 className 或测试属性。

# 场景组合

当手机只是内容容器时,可以把它当成页面模块来组合;推荐把复杂 UI 放进 display.children。

mockup phone wallpaper
Now Playing
Midnight Route
Rue FM
Next up
3 new product updates
Home
6 apps pinned
Mail
Mail
AI
AI
Cam
Cam
Map
Map
Docs
Docs
Pay
Pay
Swipe up for more

API

MockupPhone 现在支持“根级简写模式”和“组合 compound 模式”两套写法。

MockupPhone

属性说明类型默认值
className追加到手机外框根节点,适合细调边框、阴影、定位等样式string-
size机身宽度预设,提供 xs 到 xl 以及 small / middle / large 别名'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'middle' | 'medium' | 'large'-
color边框主色快捷语义,映射到 border-* 类名'default' | 'neutral' | 'primary' | 'secondary' | 'accent' | 'info' | 'success' | 'warning' | 'error''default'
camera仅在 display 简写模式下生效;可关闭摄像头,或透传 className / attrs 给摄像头节点boolean | MockupPhoneCameraConfigtrue
display根级简写模式:直接声明屏幕内容、壁纸、覆盖层与显示区类名MockupPhoneDisplayConfig-
children组合 compound 模式内容,通常与 MockupPhone.Camera / Display 搭配使用any-

Compound Parts

属性说明类型默认值
MockupPhone.Camera摄像头部件,展示基础结构,可自定义 className 和 attrsFC<MockupPhonePartProps>-
MockupPhone.Display显示区部件,适合完全自定义屏幕内部 DOM 结构FC<MockupPhonePartProps>-

display 对象结构

className:显示区根节点类名
src/alt/imgClassName:内置壁纸图
children:显示区内容
contentClassName:为 children 额外包一层容器,便于做绝对定位和覆盖层

FAQ

什么时候用 display,什么时候可以写 MockupPhone.Display?

如果只是想快速搭一个手机画面,优先用display。如果你需要自己决定显示区里的完整节点树,或者已经在复用基础示例,可以用MockupPhone.Camera和MockupPhone.Display会更直观。

color 和 className 应该怎么选?

color负责常用边框主题色,适合快速选主色;className 负责更细的样式控制,比如任意十六进制边框色、自定义阴影或缩放。

如何在壁纸上叠加浮层内容?

让display.className具备relative和 overflow-hidden,再把浮层内容放进children,通过contentClassName设置 absolute inset-0即可。

页内导航
页内导航
文档
  • 深度指南
  • 实战例子
  • 快速上手
  • 术语表
  • 错误码参照表
关于
  • 常见问题
  • 团队
  • 版本发布
  • 社区指南
生态
  • 插件
  • 组件库
  • 路由指南
  • Text.js
© 2024-2026 Xiangmin Liu
Rue.JS