# 组件表达式属性

本文介绍在表达式中可以获取到的所有组件（控件）的属性，如[姓名].[值]可以获得“姓名”输入框中的内容。

仪表板、报表和SuperPage支持的组件的属性如下：

SuperPage{#spg}
报表{#rpt}
仪表板{#dash}

# SuperPage

# 通用属性

# 值 - value

返回组件的值（内容），每个组件都有此属性，不同的组件返回的具体内容有所不同:

输入框组件返回值
文本框组件返回文本框内容
图片组件返回图片的url
TODO

# 文本 - txt

返回组件值对应的文本：

输入框组件可能返回带千分符的字符串
选择面板返回勾选的维项对应的文字
TODO

# 勾选值 - checked

对于数据列表类组件（如列表、移动列表、浮动面板等），通过勾选值属性可以获取到列表内被勾选了的数据：

[列表1].[勾选值] 返回列表中被勾选的行的主键字段值的数组，主键字段就是列表绑定的数据集的主键字段。
[列表1].[勾选值].[企业名称] 返回列表中被勾选的行的“企业名称”字段值的数组。

通过FSEL函数也能实现勾选值属性的功能，例如：

FSEL([列表1].[企业名称], [列表1].[勾选值]) 等价于 [列表1].[勾选值].[企业名称]。

# 勾选行数 - checkedCount

对于数据列表类组件（如列表、移动列表、浮动面板等），通过勾选行数属性可以获取到列表内被勾选了的数据的行数，如[列表1].[勾选行数]。

通过FCOUNT函数也能实现勾选行数属性的功能，例如FCOUNT([列表1].[勾选值]) 等价于 [列表1].[勾选行数]。

# 选中值 - selected

对于数据列表类组件（如列表、移动列表、浮动面板等），通过选中值属性可以获取到列表内被选中了的数据（选中和勾选不同，对于列表来说，选中行表示被高亮选择的行）：

[列表1].[选中值] 返回列表的被选中行的主键字段值的数组，主键字段就是列表绑定的数据集的主键字段。
[列表1].[选中值].[企业名称] 返回列表中被选中的行的“企业名称”字段值的数组，列表可以支持多行同时被选中。

通过FSEL函数也能实现选中值属性的功能，例如：

FSEL([列表1].[企业名称], [列表1].[选中值]) 等价于 [列表1].[选中值].[企业名称]。

# 选中行数 - selectedCount

对于数据列表类组件（如列表、移动列表、浮动面板等），通过选中行数属性可以获取到列表内被选中了的数据的行数（选中和勾选不同，对于列表来说，选中行表示被高亮选择的行），如[列表1].[选中行数]。

通过FCOUNT函数也能实现选中行数属性的功能，例如FCOUNT([列表1].[选中值]) 等价于 [列表1].[选中行数]。

# 数据集

这里的“数据集”泛指所有被引入或添加到页面内的数据对象，包括模型表、加工、数据集等，这些对象在表达式中提供了一些属性，包括如下：

# 总行数 - totalRowCount__

返回数据集当前查询的总行数。

# 当前页行数 - rowCount__

返回数据集当前分页的行数。

# 总页数 - totalPageCount__

返回数据集当前查询的总页数。

# 是否有上一页 - hasPreviousPage__

返回数据集是否有下一页数据，为true时可以进行向后翻页。

# 是否有下一页 - hasNextPage__

返回数据集是否有上一页数据，为true时可以进行向前翻页。

# 每页行数 - pageSize__

返回数据集每页的行数。

# 当前页 - pageIndex__

返回数据集当前查询在第几页。

# 排序 - OrderBy__

返回数据集当前查询的排序字段，如QYLX desc，JYFW asc。

# 排序字段 - OrderFields__

返回数据集当前查询的排序字段列表，是一个数组，如["QYLX","JYFW"]。

# 数据集状态 - ReadyState__

返回数据集当前状态，包括：

noload 未发起查询
loading 正在查询
nodata 未查询到数据
nosearchresult 当前显示的是搜索结果，但是没有搜索到任何结果
searching 正在搜索数据，表示用户输入了搜索关键字，系统正在搜索关键字，且还没有搜索完成时的状态

# 修改状态 - Modified__

返回数据集是否存在数据修改，true表示数据集的某些行被修改、删除或新增过，但还未提交，当数据集提交后状态变为false。

# 特殊数据字段

通过这里所说的特殊数据字段可以获取数据集中某行数据的一些内部信息，包括：

# 行修改状态 - RowModifiedState__

返回某行的修改状态，有如下的可选值：

`` 空，表示数据行是从后台数据库加载出来的，未修改过。
add 新增的数据行，还未提交，提交后变为空。
init 初始化出来的数据行，还未修改过，如果有修改会变为modified。
modified 修改过的数据行，提交后变为空。

# 行校验状态 - RowValidateState__

`` 空，表示未知。
ok 表示校验过，且结果正常。
error 表示校验过，且结果错误。

# 行校验描述 - RowValidateErrMessage__

当校验出现错误时返回错误描述。

# 地点分布

# 绘图地理信息 - drawgeometry

返回地图使用绘图工具产生的绘图结果。返回的信息是一个地理几何结构，如方圆500米AROUND(117.195907,39.118327, 500)、矩形rectangle(117.195907,39.118327, 116.925304,38.935671)或多边形polygon(117.195907,39.118327, 116.925304,38.935671, 117.654173,39.032846)。

# 报表

# 仪表板

数据类型

$browser

0条评论