按钮控件

可选择的按钮类型，有 6 种，如下：

注：移动端不支持参数提交按钮和树节点按钮

1）普通：最常规的按钮，可设置按钮名字、按钮图标、快捷键，详细介绍见表格的内容

2）自定义：相比普通按钮，可以自定义按钮背景样式，样式包括初始背景、鼠标浮动背景、鼠标点击背景

3）插入行：添加后，点击按钮可插入单元格行。属性介绍见表格的内容，使用案例可参考：插入和删除行列

4）删除行：添加后，点击按钮可删除单元格行。属性介绍见表格的内容，使用案例可参考：插入和删除行列

注：删除行按钮不支持设置「提交入库」事件

5）参数提交按钮：用来提交参数，添加后点击即可提交报表中的参数，即默认生成一个查询按钮，属性介绍见表格的内容

6）树节点按钮：用来制作树形展开的 折叠报表，将控制附属于该组的内容展开与折叠

注：树节点按钮只支持「数据分析」预览方式

在按钮上显示的值，默认为空。如果同时设置了按钮名字和单元格值，则优先显示按钮名字

注：暂不支持通过修改单元格字体大小和字体颜色来调整按钮显示文字的大小和颜色

按钮显示的图标样式，有预定义选项；也可以通过添加图片自定义，自定义图片建议使用 16×16 规格的 PNG 图片，否则会出现图标显示不完整的情况

注：模板更换服务器环境后，按钮图标需要重新添加和配置

可通过手动输入来自定义「快捷键」，执行按钮的点击动作，悬浮可查看支持的快捷键。

注：此功能不支持移动端

控件类型选择「自定义」时的配置项，可自定义初始背景，可设置为没有背景、颜色、纹理、图案、渐变色、图片

注：移动端背景仅支持颜色

控件类型选择「自定义」时的配置项，可自定义鼠标浮动背景，可设置为没有背景、颜色、纹理、图案、渐变色、图片

注：此功能移动端不支持

控件类型选择「自定义」时的配置项，可自定义鼠标点击背景，可设置为没有背景、颜色、纹理、图案、渐变色、图片

注：移动端背景仅支持颜色

在按钮上显示的值，默认为 button#

按钮背景样式，有 2 种，如下：

1）普通：蓝色背景按钮

2）自定义：可以自定义按钮样式，样式包括初始背景、鼠标浮动背景、鼠标点击背景

默认为「普通」

背景选择「自定义」时的配置项，可自定义初始背景，可设置为透明、颜色、图片注：移动端背景仅支持颜色

按钮显示的图标样式，有预定义选项；也可以通过添加图片自定义，自定义图片建议使用 16×16 规格的 PNG 图片，否则会出现图标显示不完整的情况

注1：模板更换服务器环境后，按钮图标需要重现添加和配置

注2：服务器上传自定义图标若不显示，可以尝试清除浏览器缓存即可

可通过手动输入来自定义「快捷键」，执行按钮的点击动作，悬浮可查看支持的快捷键

注：此功能不支持移动端

场景描述：

制作的复杂视图树报表，在预览时，需要点击父节点，才会展开下一层子节点，当层数比较多的时候，操作比较麻烦。如果用户想实现一键全部展开或收起，可以使用按钮控件。

参考文档：

JS实现一键展开/收起视图树所有节点

场景描述：

利用按钮控件可以设置插入行

参考文档：

插入行策略

场景描述：

通过按钮控件的树节点按钮，在报表有明细列和汇总列的时候，可以实现一开始只展现汇总列，点击之后再展现明细列。

参考文档：

数据分析模式动态表头

场景描述：

参数控件较多的情况下，可以对一些不常用、不需要展现出来的的控件进行隐藏，当需要展示的时候再使其展示出来，为「按钮控件」添加点击事件，当点击按钮时，隐藏或显示指定的其他类型控件。

参考文档：

JS 实现动态隐藏参数以及控制参数面板高度

场景描述：

当报表有多个 Sheet 时，可以通过参数面板上按钮跳转到指定的 Sheet 页

参考文档：

JS实现点击按钮切换Sheet页