页面与弹窗参考

页面和弹窗都是承载 UI 的界面单元，都可以包含组件树，并支持设计、数据和行为配置。

对象定义

对象	管理位置	打开方式	典型用途
页面	左边栏「页面」列表	通过路由、导航或跳转访问	首页、列表页、详情页、个人中心页
弹窗	左边栏「弹窗」列表	通过「打开弹窗」行为唤起	确认框、表单弹层、详情弹层、抽屉

页面和弹窗都可以配置尺寸、布局、样式等通用设计项。通用字段见设计面板参考。

💡

弹窗内部是一块独立画布，可以像页面一样添加文本、按钮、输入框、列表等组件。

页面和弹窗都可以承载数据上下文。数据配置用于让内部组件读取数据或在行为中传参。

配置项	页面	弹窗
数据源	页面级查询/订阅，常用于整页共享查询结果。	弹窗级查询/订阅，常用于弹窗内部展示详情或加载表单数据。
变量	页面运行期间的临时状态。	弹窗运行期间的临时状态。
输入 / 入参	页面可通过路径参数、查询参数等接收外部数据。	弹窗可在打开时接收输入数据。

数据绑定、数据源和参数的完整说明见数据绑定、变量和参数。

页面和弹窗都可以配置行为，但触发时机不同。

对象	常见触发时机 / 行为
页面	页面加载时、页面卸载时、定时任务等。
弹窗	弹窗内部组件点击、提交表单、关闭弹窗等。

页面加载行为常用于初始化页面状态，例如设置变量、请求数据或打开提示。定时任务适合按时间间隔触发的前端行为。

弹窗通常由页面或组件上的行为打开，并在弹窗内部通过按钮等组件关闭或提交。

动作	说明
打开弹窗	在页面或组件行为中选择目标弹窗，并按需传入输入数据。
关闭弹窗	在弹窗内部组件行为中关闭当前弹窗或指定弹窗。

行为模型和动作列表见行为配置。

场景	建议
需要一个可访问的主界面	使用页面。
需要临时显示确认、表单或详情	使用弹窗。
多个组件都要使用同一份数据	放在页面或弹窗的数据源中。
弹窗要展示当前列表行数据	打开弹窗前，将当前列表项数据作为输入传入，或先写入页面变量。