参数- 单元格-属性及效果 -表单工具
目录

参数

功能用途说明

“参数”增强控件的主要用途是为单元格命名。

在使用交互增强控件制作输入表单页面时,要求为其设置“名称”,实际上这里的名称就用做单元格的名称,即提交时的参数名。

例如,某单元格使用文件选择器增强控件,且设置了名称为“filePath”,则该单元格即被命名为“filePath”,当获取提交数据时,得到的JSON中会有filePath参数。

有时,有些单元格可能并没有使用交互增强控件,也就没有为单元格命名。例如,某单元格使用下拉列表编辑风格进行数据回填,同时希望提交数据时,也把此单元格作为参数进行提交,那么,就需要用“参数”增强控件为此单元格命名。

配置项说明

名称

增强控件标识。该属性值应该保证页面内唯一,否则该控件被其他单元格引用时会出错。请参考 引用

此项为必填项。

引用

其他单元格的名称。复制其他单元格的样式信息(包括边框、前景色、背景色、字体等内容)。请参考 引用。此属性为可选项。

值监听

设置单元格值变化时的回调函数。该单元格值(指的是单元格的value属性值)发生变化时,自动调用此函数,并传递当前单元格值。请参考 文件选择器 中的使用方法。此属性为可选项。

参数引用

当多个单元格的数据相互关联时,需要用“@名称”的语法来获取对应单元格的值。例如实时保存中的主键值从其他单元格获取,再如小统计图中的统计数据从其他单元格获取,都需要使用“@名称”的方式来获取数据。

@paramName,表示的是获取名称为paramName的单元格的值,而paramName是在插入各种增强控件时为其设置的名称。

这里所说的增强控件指的是独立单元格的增强控件,包括:所有选择器、上传文件、实时保存、小统计图、参数;
按钮等其他类型增强控件,虽然设置了名称,但不会关心其单元格的值;而实时数据刷新则是针对一个区域(多个单元格)命名。

示例

参数的设置:

如上图:添加参数后,需要设置名称,如需添加其余效果,可参考【配置项说明】进行添加设置。