文档中心按钮
什么是按钮
按钮是工作簿级内部元素，一般用于挂载执行对象（python,计算流,自定义JS），通过触发按钮达到数据计算、数据保存、页面刷新等操作。
按钮类型主要分为两种:固定按钮和下拉按钮，用户可以根据需要新增。
示意图如下：
默认按钮
每个工作簿都会有4个默认按钮：保存当前，保存全部，刷新当前，刷新全部。这4个按钮允许用户隐藏或者重命名。4个按钮的编码固定为 save，save_all，refresh，refresh_all 且不可编辑。这4个编码是用来判断该按钮是否是固定按钮的依据。因此，在用户自己新增按钮时，不允许用这4个编码。
|
属性名称 |
作用 |
|---|---|
|
保存当前 |
使用视图中保存当前工作表并自动刷新当前工作表 |
|
保存全部 |
使用视图中保存全部工作表并自动刷新全部工作表 |
|
刷新当前 |
使用视图中刷新当前工作表 |
|
刷新全部 |
使用视图中刷新全部工作表 |
-
这4个固定按钮不允许删除，可设置隐藏，隐藏后，在使用视图按钮无法被触发。
-
默认按钮不论如何修改名称、提示，其功能始终不变。
-
默认按钮可以同自定义按钮一起拖拽排序。
按钮创建
-
添加按钮
-
按钮移动
-
按钮复制
-
按钮删除
配置基本信息
点击左侧按钮栏：
属性如下：
|
属性名称 |
说明 |
是否必填 |
|---|---|---|
|
编码 |
系统自动生成-工作簿内唯一，可以理解成按钮id |
是 |
|
描述（中文/英文） |
指按钮描述 |
否 |
|
提示（中文/英文） |
指按钮名称，为空时用“编码”显示 |
否 |
|
隐藏范围 |
指按钮在哪些Sheet上需要隐藏，默认在全部Sheet显示 |
否 |
描述
在基本信息模块中，对描述配置录入需展示文案即可，录入格式不限
提示
在基本信息模块中，对提示配置录入需展示文案即可，录入格式不限
隐藏范围
在基本信息模块中，可设置按钮在全部sheet隐藏，也可以指定sheet隐藏
配置执行信息
点击“执行信息”页签：
属性如下：
|
字段名称 |
说明 |
是否必填 |
|---|---|---|
|
执行对象 |
支持python脚本,计算流,自定义JS |
否 |
|
异步运行 |
设置后，执行对象将进入作业中后台运行，并且不会刷新表单。默认不勾选 |
否 |
|
运行后刷新表单 |
设置后，脚本执行成功时会自动刷新表单（刷新当前/刷新全部）。默认不勾选 |
否 |
|
脚本参数 |
对于Python和计算流，可配置脚本运行参数的赋值方式 |
否 |
|
运行前弹窗显示脚本参数 |
设置后，触发按钮会弹窗提示参数的值 |
否 |
“异步运行”和“运行后刷新表单”是互斥属性
执行对象
切换执行对象和选元素：
异步运行
异步运行时，可前往作业管理查看当前脚本的运行情况。
运行后刷新表单
-
若未设置运行后刷新表单，脚本已经执行成功，需手工刷新才能更新数据
-
运行后刷新表单
参数赋值方式
脚本参数的赋值方式有4种：
-
脚本默认值：使用计算脚本元素中配置的参数默认值作为运行条件
-
wb筛选器：通过工作簿级筛选器给计算脚本传参
-
st筛选器：通过每个工作表的Sheet级筛选器给计算脚本传参
-
无：参数值置空
运行前弹窗显示脚本参数
-
允许前弹窗显示脚本参数-勾选
-
允许前弹窗显示脚本参数-不勾选
配置按钮样式
|
字段名称 |
说明 |
|---|---|
|
图标 |
按钮内的icon |
|
字体 |
按钮字体，系统默认可修改 |
|
界面 |
按钮界面展示设置如悬浮,溢出,悬浮等 |
|
边距 |
按钮文字间距设置 |
|
阴影 |
按钮内外边框阴影设置 |
|
恢复默认样式 |
点击将更改项全部恢复成最初系统默认的 |
使用态效果如下：
回到顶部
咨询热线
400-821-9199
