变量和参数
应用运行时会产生需要暂存或传递的数据。变量用于在当前上下文中保存和修改临时状态;参数用于在页面跳转或逻辑调用时传递数据。
需要长期保存的数据应存储在数据库中。
变量
变量描述某个运行时上下文中的临时状态。它的值可以在作用域内读取和修改。
不同类型的变量具有不同的可访问范围和生命周期:
| 类型 | 可用范围 | 当前值失效时机 | 示例 |
|---|---|---|---|
| 客户端变量 | 当前客户端中的多个页面 | 页面刷新、客户端重新加载或关闭后 | 跨页面的临时选择、显示偏好 |
| 页面、弹窗和组件变量 | 声明它的页面、弹窗或组件实例 | 对应实例卸载后 | 搜索条件、未提交输入、选中状态 |
| 行为流变量 | 当前行为流的一次执行过程 | 本次行为流执行结束后 | 中间计算结果、循环累计值 |
页面变量的创建和使用,参见使用页面变量和页面参数;客户端变量的赋值,参见客户端和页面行为;行为流变量的配置,参见搭建行为流。
参数
参数用于在页面之间或逻辑调用的两端传递数据。页面参数为目标页面提供数据;逻辑调用通过入参接收数据,并通过出参返回结果。
页面参数
页面参数用于在页面跳转时向目标页面传递数据。Web 页面参数分为路径参数和查询参数:
- 路径参数是页面路由模板中的动态部分,会影响生成的页面路径。
- 查询参数是附加在页面地址后的键值对,不改变页面路径本身。
页面参数的配置和传值,参见使用页面变量和页面参数。
组件出参
输入型组件将当前输入值作为组件出参对外暴露,供其他对象绑定。
行为流、API 和 AI Agent 参数
调用行为流、API 或 AI Agent 时,调用方通过入参传入数据,并在调用完成后通过出参(行为结果)获取返回数据。
行为流、API 和 AI Agent 的入参及结果配置,分别参见搭建行为流、集成第三方 API和搭建 AI Agent。
相关文档
Last updated on