您可以使用Form Bridge API打开基于XFA的HTML5表单与您的应用程序之间的通信渠道。 Form Bridge API提供了 connect 用于创建连接的API。
此 connect API接受处理程序作为参数。 在基于XFA的HTML5表单与表单桥接器之间成功创建连接后,将调用句柄。
您可以使用以下示例代码创建连接。
// Example showing how to connect to FormBridge
window.addEventListener("FormBridgeInitialized",
function(event) {
var fb = event.detail.formBridge;
fb.connect(function() {
//use form bridge functions
})
})
确保在包含formRuntime.jsp文件之前创建连接。
getBridgeVersion()
返回脚本库的版本号
isConnected() 检查表单状态是否已初始化
输入:无
输出: True 如果XFA表单状态已初始化
错误:无
connect(handler, context) 与FormBridge建立连接,并在建立连接且Form State初始化后执行函数
输入:
输出:无
错误:无
getDataXML(options) 以XML格式返回当前表单数据
输入:
选项: 包含以下属性的JavaScript对象:
输出: 无
错误: 无
registerConfig(configName, config) 向FormBridge注册用户/门户特定配置。 这些配置将覆盖默认配置。 支持的配置在配置部分中指定。
输入:
configName: 要覆盖的配置名称
widgetConfig: 允许用户使用自定义构件覆盖表单中的默认构件。 将按如下方式覆盖配置:
formBridge.registerConfig("widgetConfig":{/*configuration*/})
pagingConfig: 允许用户覆盖仅呈现第一页的默认行为。 将按如下方式覆盖配置:
window.formBridge.registerConfig("pagingConfig":{pagingDisabled: <true false="">,shrinkPageDisabled: <true false=""> })。
Loggingconfig: 允许用户覆盖日志记录级别,禁用某个类别的日志记录,或者是否显示日志控制台或发送到服务器。 可按如下方式覆盖配置:
formBridge.registerConfig{
"LoggerConfig" : {
{
"on":`<true *| *false>`,
"category":`<array of categories>`,
"level":`<level of categories>`, "
type":`<"console"/"server"/"both">`
}
}
SubmitServiceProxyConfig: 允许用户注册提交和记录器代理服务。
window.formBridge.registerConfig("submitServiceProxyConfig",
{
"submitServiceProxy" : "`<submitServiceProxy>`",
"logServiceProxy": "`<logServiceProxy>`",
"submitUrl" : "`<submitUrl>`"
});
配置: 配置的值
输出: 包含配置原始值的对象 数据 属性。
错误: 无
hideFields(fieldArray) 隐藏fieldArray中提供Som表达式的字段。 将指定字段的presence属性设置为不可见
输入:
输出: 无
错误: 无
showFields(fieldArray) 显示其Som表达式在fieldArray中提供的字段。 将所提供字段的presence属性设置为可见
输入:
输出: 无
错误: 无
hideSubmitButton() 隐藏表单中的所有提交按钮
getFormState() 返回表示表单状态的JSON
输入: 无
输出: 包含表示当前表单状态的JSON的对象 数据 属性。
错误: 无
restoreFormState(options) 从选项对象中提供的JSON状态恢复表单状态。 应用状态,并在操作完成后调用成功或错误处理程序
输入:
选项: 包含以下属性的JavaScript对象:
输出: 无
错误: 无
setFocus (som) 将焦点设置为Som表达式中指定的字段
setFieldValue (som, value) 设置给定Som表达式的字段值
输入:
输出: 无
错误: 如果Som表达式不正确,则引发异常
getFieldValue (som) 返回给定Som表达式的字段值
输入: 包含必须检索其值的字段的Som表达式的数组
输出: 将结果作为数组包含在中的对象 数据 属性。
错误: 无
var a = formBridge.getFieldValue("xfa.form.form1.Subform1.TextField");
if(a.errors) {
var err;
while((err = a.getNextMessage()) != null)
alert(a.message)
} else {
alert(a.data[0])
}
getFieldProperties(som, property) 检索Som表达式中指定的字段的给定属性的值列表
输入:
输出: 将结果作为数组包含在中的对象 数据 属性
错误: 无
setFieldProperties(som,属性,值) 为Som表达式中指定的所有字段设置给定属性的值
输入:
输出: 无
错误: 无
// Example 1: FormBridge.restoreFormState
function loadFormState() {
var suc = function(obj) {
//success
}
var err = function(obj) {
while(var t = obj.getNextMessage()) {
$("#errorDiv").append("<div>"+t.message+"</div>");
}
}
var _formState = // load form state from storage
formBridge.restoreFormState({success:suc,error:err,formState:_formState}); // not passing a context means that this will be formBridge itself. Validation errors will be checked.
}
//--------------------------------------------------------------------------------------------------
//Example 2: FormBridge.submitForm
function SubmitForm() {
var suc = function(obj) {
var data = obj.data;
// submit the data to a url;
}
var err = function(obj) {
while(var t = obj.getNextMessage()) {
$("#errorDiv").append("<div>"+t.message+"</div>");
}
}
formBridge.submitForm({success:suc,error:err}); // not passing a context means that this will be formBridge itself. Validation errors will be checked.
}