Skip to Content

实时预览

实时预览(Mirror)是在 Web 中运行的客户端模拟环境。它直接读取编辑器中的当前配置,不需要编译或打包,适合在发布前快速检查页面、数据和交互。

实时预览不等同于发布流程中的预发布版本。涉及真实设备、客户端专属能力或最终构建结果时,仍需通过预发布版本验证。

打开实时预览

可以从项目首页或指定页面开始预览:

  1. 点击编辑器右上角的实时预览,从项目首页开始。
  2. 如需从指定页面开始,先在画布中选择该页面,再点击页面工具栏中的实时预览
  3. 在预览窗口底部选择客户端环境、设备尺寸或自定义分辨率。

设置初始化数据

初始化配置中设置页面启动时需要的数据。可配置的内容取决于当前页面,包括:

  • 页面入参
  • 路径参数
  • 查询参数
  • 客户端变量
  • Mock 数据

修改初始化配置后,重新加载预览,使页面按新的数据重新初始化。

模拟用户状态

点击模拟登录,选择或创建测试用户。通过切换测试用户,可以检查不同登录状态、用户数据和角色权限下的页面结果。

模拟用户时,应重点检查:

  • 页面是否正确读取当前用户数据
  • 数据源是否遵循用户权限
  • 不同角色是否看到正确的页面内容
  • 行为和行为流是否使用了正确的用户上下文

调试页面

点击扳手图标进入调试模式,然后选择页面中的组件,查看该组件当前的数据状态。结合初始化配置和模拟登录,可以检查:

  • 数据绑定结果
  • 页面参数和客户端变量
  • 条件显示结果
  • 组件在交互前后的状态变化

如果修改了参数、变量或测试用户,请重新加载预览后再检查结果。

发布前检查

在开始发布前,建议使用实时预览检查:

  1. 页面在目标客户端环境和设备尺寸下是否正常显示。
  2. 页面入参、路径参数和查询参数是否正确传递。
  3. 登录、未登录和不同角色下的数据与权限是否符合预期。
  4. 页面数据源、前端行为和行为流是否正常执行。
  5. 成功时、失败时和空数据等分支是否都有正确结果。

实时预览与预发布版本

对比项实时预览预发布版本
运行方式在 Web 中模拟客户端环境编译并生成客户端构建结果
是否打包
使用内容编辑器中的当前配置本次发布包含的前端与后端配置
适合检查页面、数据、参数、用户状态和常规交互真实构建结果、客户端专属能力和实际运行环境

实时预览结果与实际客户端不一致时,先检查初始化数据、测试用户和客户端环境是否一致;涉及设备能力或客户端差异时,以预发布版本的验证结果为准。

Last updated on