填报JS接口说明

API接口汇总 中公共模块和填报预览专有的接口，都支持在填报预览下使用。

2.1 控件接口

填报模板，会存在参数面板上的控件和填报单元格中的控件。

获取参数面板上的控件，可参考：参数面板接口

获取填报单元格中的控件，可参考：填报预览专有

两者都支持的可参考 获取控件，但仅支持在控件的「事件」中使用。

2.2 单元格接口

获取单元格、给单元格赋值，获取和设置单元格值接口

2.3 工具栏接口

获取工具栏，可参考：工具栏

对工具栏中按钮操作，可参考：工具工具栏按钮通用、邮件按钮专有

2.4 填报页面接口

填报页面接口，可参考：填报预览专有

2.5 消息接口

消息接口可参考：FR.Msg

2.6 其他接口

其他接口可以可参考：API接口汇总

1）如果是在初始化事件中使用 JS 但未生效，可以尝试加上延时函数 setTimeout。示例如下：

setTimeout(function() {
	_g().getWidgetByCell("A1").setEnable(false);
	//将A1单元格控件设置为不可用
}, 500)
//延时0.5s执行

2）当使用了延时函数 setTimeout 时，this 对象就会失效，可以将 this 放在延时函数外进行赋值调用来避免。示例如下：

var widget=this;
setTimeout(function() {
	widget.setEnable(false);
	//将当前控件设置为不可用
}, 500)
//延时0.5s执行

3）当清空单元格控件时，建议同时清空控件值和单元格值，否则可能会出现清空失败的情况。示例如下：

_g().getWidgetByCell("A1").setValue("");
//清空A1单元格控件值
_g().curLGP.setCellValue("A1", "");
//清空A1单元格值

注：给单元格控件赋值时同理，最好同时给控件和控件所在单元格都赋值

4）如果控件设置了不能为空，则会使清空失效。设置了不允许自定义值，则只能赋数据字典中存在的值：

5）如果 Widget 是一个控件数组，则不能直接调用相关方法，需要通过遍历来实现。示例如下：

var widgets = _g().getWidgetsByName("demo");
//获取控件名称为demo的控件数组
for (i = 0; i < widgets.length; i++) {
	widgets[i].setEnable(false);
	//遍历禁用控件
}

6）填报预览下，用单元格编号获取的单元格是一个具体的单元格，不会自动识别扩展场景。

比如 A1 扩展出 3 条数据，用 JS 给 A1 赋值时，就只是赋给第一条数据。此时可以用公式获取 A1 扩展出的数据个数，遍历执行相关方法。

示例如下，其中 len 参数为公式 len(A1) 的值。

for (i = 0; i < len; i++) {
	_g().setCellValue(0, 0, i, "帆软")
	//给A1扩展出的所有单元格赋值
}

7）单元格控件和其所在的单元格是 2 个独立的元素，在大部分填报获取单元格值和给单元格赋值的场景下，都需要直接对单元格进行操作，而不是控件，否则可能出现获取不到正确值的问题。

有种特殊情况是，当控件填入值未失焦的情况下，此时控件值还未写入单元格，所以这时就需要用获取控件值的接口去获取该输入的值。