数据源绑定

文文档为您介绍移动应用常用动态数据的绑定及使用方式。

动态数据场景

应用的展示与交互依赖动态数据，例如数据列表展示与筛选、数据提交、组件交互等。

API 是指在后台 API 中心配置的接口数据，接口包含输入参数及输出参数。输入参数可以用来配置表单提交字段，输出参数一般用来配置展示数据。模型数据源是后台配置的模型实体(数据表)，可以通过内置的模型接口对数据进行增删改查操作。具体参考文档

循环数据是基于 API/模型数据的一种中间数据，例如容器对 API 返回结果的某个数组字段进行循环渲染，里面的子组件可以通过循环数据来直接获取到当前循环项里面的字段。具体参考文档

变量指应用运行时的临时变量，可以进行定义及修改，任意组件及事件均可对当前页面或者全局的变量进行读取及修改操作，变量更新后将自动同步到组件内。变量包含页面变量及应用变量两种，页面变量只在当前页面生效，应用变量则在整个应用运行时生效。具体参考文档

参数指页面跳转的传参，如详情页一般需要 id 参数来通过 API 或者模型读取详情信息。在对应页面声明参数后，事件动作里跳转到该页面就会出现对应参数的配置项。页面运行时可以直接读取参数值，但相对于变量，参数只有默认的字符串格式并且不支持动作修改。

事件上下文变量指部分组件在运行时交互产生的上下文变量，例如搜索组件可以通过上下文变量获取到变更的搜索值，下拉菜单可以获取到选择的选项名称及选项值。获取到上下文变量后方便后续事件动作的传参及处理来实现交互效果。具体可以参考对应组件的上下文变量说明。

系统变量可以读取当前用户、当前日期等系统信息。

自定义代码可以在运行时通过代码方式给组件动态赋值，例如读取变量、数据源字段并进行格式化或者其他处理等。只需要在赋值面板选择自定义代码，编写对应的 JS 代码并 return 返回值即可。前端 API 可以参考此文档

表单字段绑定是特殊的动态数据配置方式，主要用来配置动态数据提交格式。表单组件需要放置在表单容器里(支持布局容器嵌套)。表单容器绑定数据源后，每个表单组件会自动更新对应的数据源，对单个组件选择对应数据源的输入参数字段即可完成绑定，表单提交时将按照配置字段及数据进行提交。

如果表单提交某个字段需要数组格式，可以搭配明细表使用。明细表绑定输入参数的数组字段，明细表容器内绑定数组下面的对象字段即可。