最新历史版本 :单选按钮组控件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本
功能变更
11.0-

1.2 应用场景

1.2.1 填报控件

填报报表中可以通过该控件录入填报的数据，如下图所示：

02.jpg

1.2.2 参数控件

参数面板处可以通过该控件过滤数据，如下图所示：

2.png

1.3 如何添加

1.3.1 填报控件

选中单元格后，点击右侧属性面板的「控件设置」，「选择控件」处下拉选择「单选按钮组控件」，如下图所示：

1.3.2 参数控件

将参数面板控件工具栏中的「单选按钮组控件」拖入到参数面板中，如下图所示：

1.4 使用说明

复选按钮、单选按钮组、复选按钮组的区别：

  • 复选按钮仅有一个按钮，按钮两个值 true 或者 false ,分别对应选择与不选择，适合是否选项的场景。

  • 单选按钮组可以有多个按钮，每个按钮对应一个值，在多个按钮组成的按钮组中选择其中一个，适合多个选项选一个的场景。

  • 复选按钮组也可以有多个按钮，每个按钮对应一个值，在多个按钮组成的按钮组中可以选择多个，适合多个选项选择数可以大于 1 的场景。

如下图所示：

2. 控件介绍编辑

2.1 属性

2.1.1 填报控件

「单选按钮组控件」的属性设置界面如下图所示：

各属性设置项的详细介绍如下表所示：

注：「单选按钮组控件」在填报应用时，可通过在单元格中添加值的方式设置默认值，值可以为数据字典绑定的实际值，也可以为显示值。

分类
设置项详细介绍
基本控件名称控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为无。
可      用控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。
可      见控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。
高级
数据字典

绑定控件的待选择项，必须设置，否则控件不显示，如何设置可参考：数据字典

注：不支持通过设置单元格字体颜色来调整数据字典选项的字体颜色。

自适应

是否根据待选择的项调整展示列数，勾选后，根据待选择的项展示列数；不勾选，需自行设置展示列数，若展示不下将截断展示，默认勾选。

展示列数不勾选「自适应」后出现的设置项，可自行设置展示列数，默认为 0。
校验允许为空是否允许控件不选择项，勾选后，允许控件不选择；不勾选，填报校验和提交时会提示，默认勾选。
错误提示不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空

2.1.2 参数控件

「单选按钮组控件」的属性设置界面如下图所示：

各属性设置项的详细介绍如下表所示：

分类
设置项详细介绍
基本控件名称控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为 radioGroup# 。
可       用控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。
可       见控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。
高级标签名称控件的标签属性是用在移动端的，移动端不支持参数面板上的「标签控件」，识别的是普通控件的「标签名称」属性，所以移动端可以用控件的标签名称来实现标签。
控 件 值

控件初始化时的默认值，可以为数据字典时绑定的实际值，也可以为显示值。支持字符串、字段、公式，默认为空。

1）字符串：字符文字，例如：华北

2）字段：数据集字段，数据集包括模板数据集和服务器数据集。例如：数据集 ds1 的地区字段

3）公式：设计器支持的公式，例如： A1 单元格的值

数据字典绑定控件的待选择项，必须设置，否则控件不显示，如何设置可参考：数据字典
字      体

显示待选项的字体大小，默认为 12 。

注：此功能不支持移动端使用。

自适应是否根据待选择的项调整展示列数，勾选后，根据待选择的项展示列数；不勾选，需自行设置展示列数，若展示不下将截断展示，默认勾选。
展示列数不勾选「自适应」后出现的设置项，可自行设置展示列数，默认为 0。
校验允许为空是否允许控件不选择项，勾选后，允许控件不选择；不勾选，填报校验和提交时会提示，默认勾选。
错误提示不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空
坐标.尺寸控件位置控件在参数面板中的位置，通过横纵坐标调整，坐标会根据控件在参数面板中的位置自动显示。
控件大小控件的大小，通过宽度、高度调整，若通过拖拽调整，高宽度也随着自动调整。

2.2 事件

事件设置界面可以为控件添加事件实现某些效果，「单选按钮组控件」支持的事件有初始化后、状态改变。如下图所示：

选择一种事件类型后，即可添加事件内容，「单选按钮控件」支持的事件响应方式有 JavaScript 脚本、提交入库、发送邮件。如下图所示：

选择对应的事件响应方式添加即可，不同响应方式区别可参考：事件响应方式

2.3 移动端

2.3.1 填报控件

移动端无可配置项。

2.3.2 参数控件

移动端设置界面如下图所示：

2021-10-25_14-30-31.png

移动端单选按钮组控件样式设置参见：［通用］单选按钮组移动端按钮组样式

最大显示行数逻辑如下表所示：

报表类型
控件位置是否移动端重布局显示逻辑
普通报表参数界面-

根据控件选项扩展的行数，显示区域不同：

1）若实际行数＜最大显示行数，则组件区域的高度自动扩展，显示全部选项，无多余空白行，无滚动条

2）若实际行数≥最大显示行数，则组件区域的高度先扩展，显示最大显示行数，其余通过滚动条显示

3）若最大显示行数为 0 ，组件区域由组件宽高比例决定，组件显示行数由组件区域决定，显示不下将出现滚动条

决策报表
参数界面-
body 界面勾选移动端重布局
未勾选移动端重布局

组件区域由组件宽高比例决定，高度无法自由扩展

组件显示行数由组件区域决定，显示不下将出现滚动条，不受最大显示行数约束

3. 应用示例编辑

单选按钮组控件的应用，可参见以下文档：

应用场景
实际效果

场景描述：

通过单选按钮组建，可以实现对一日，一周，一个月数据进行查询筛选

参考文档：

通过日周月传参查询数据

1572509878367853.gif
场景描述：

参数界面或者填报控件单选按钮组可以设置默认参数

参考文档：

单选按钮组设置默认值

场景描述：

使用单选按钮可以控制模板的显示内容为全部显示或者部分显示。

参考文档：

单选按钮组控制实现是否显示全部

1600828376147074.gif