实时预览
实时预览(Mirror)是在 Web 中运行的客户端模拟环境。它直接读取编辑器中的当前配置,不需要编译或打包,适合在发布前快速检查页面、数据和交互。
实时预览不等同于发布流程中的预发布版本。涉及真实设备、客户端专属能力或最终构建结果时,仍需通过预发布版本验证。
打开实时预览
可以从项目首页或指定页面开始预览:
- 点击编辑器右上角的实时预览,从项目首页开始。
- 如需从指定页面开始,先在画布中选择该页面,再点击页面工具栏中的实时预览。
- 在预览窗口底部选择客户端环境、设备尺寸或自定义分辨率。
设置初始化数据
在初始化配置中设置页面启动时需要的数据。可配置的内容取决于当前页面,包括:
- 页面入参
- 路径参数
- 查询参数
- 客户端变量
- Mock 数据
修改初始化配置后,重新加载预览,使页面按新的数据重新初始化。
模拟用户状态
点击模拟登录,选择或创建测试用户。通过切换测试用户,可以检查不同登录状态、用户数据和角色权限下的页面结果。
模拟用户时,应重点检查:
- 页面是否正确读取当前用户数据
- 数据源是否遵循用户权限
- 不同角色是否看到正确的页面内容
- 行为和行为流是否使用了正确的用户上下文
调试页面
点击扳手图标进入调试模式,然后选择页面中的组件,查看该组件当前的数据状态。结合初始化配置和模拟登录,可以检查:
- 数据绑定结果
- 页面参数和客户端变量
- 条件显示结果
- 组件在交互前后的状态变化
如果修改了参数、变量或测试用户,请重新加载预览后再检查结果。
发布前检查
在开始发布前,建议使用实时预览检查:
- 页面在目标客户端环境和设备尺寸下是否正常显示。
- 页面入参、路径参数和查询参数是否正确传递。
- 登录、未登录和不同角色下的数据与权限是否符合预期。
- 页面数据源、前端行为和行为流是否正常执行。
- 成功时、失败时和空数据等分支是否都有正确结果。
实时预览与预发布版本
| 对比项 | 实时预览 | 预发布版本 |
|---|---|---|
| 运行方式 | 在 Web 中模拟客户端环境 | 编译并生成客户端构建结果 |
| 是否打包 | 否 | 是 |
| 使用内容 | 编辑器中的当前配置 | 本次发布包含的前端与后端配置 |
| 适合检查 | 页面、数据、参数、用户状态和常规交互 | 真实构建结果、客户端专属能力和实际运行环境 |
实时预览结果与实际客户端不一致时,先检查初始化数据、测试用户和客户端环境是否一致;涉及设备能力或客户端差异时,以预发布版本的验证结果为准。
Last updated on