E9表单建模前端接口API:ModeForm Confirm与字段操作

需积分: 44 7 下载量 73 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
"本文主要介绍了在Cisco中型项目实战中,如何使用E9表单建模前端接口API,特别是系统样式的Confirm确认框以及与之相关的功能。文章着重讲解了`ModeForm`全局对象中的几个关键接口,如将字段名称转换成字段ID、获取单个字段值以及修改字段值的方法,这些都是在OA开发接口中常用的基础操作。同时,还提到了可控制显示时间的`showMessage`函数,用于显示不同类型的提示信息,并能设置自动消失的时间。" 在Cisco的中型项目实战中,E9表单建模提供了丰富的前端接口API,使得开发者能够更高效地进行OA开发。这些接口被封装在全局对象`window.ModeForm`中,以支持单页模式的交互。为了避免使用jQuery或直接操作DOM,推荐使用这些API接口来处理表单和列表。 `ModeForm.showMessage`是其中一个重要接口,用于显示具有不同样式和自动消失时长的提示信息。它接受三个参数:`msg`(提示信息内容)、`type`(提示类型,如1表示警告,2表示错误,3表示成功,4表示一般,默认为1)和`duration`(信息自动消失的秒数,默认为1.5秒)。例如,`ModeForm.showMessage("结束时间需大于开始时间")`将显示一个警告信息,并在1.5秒后自动消失,而`ModeForm.showMessage("运算错误", 2, 10)`则会显示一个错误信息,10秒后消失。 此外,`ModeForm`还提供了一些基础操作接口,方便开发者对表单字段进行操作。例如: 1. `convertFieldNameToId`函数用于根据字段名称生成字段ID。这个方法对于多表单或多环境的场景特别有用,可以确保代码的可复用性。它接受三个参数:`fieldName`(字段名称),`symbol`(表单标识,如主表或明细表,默认为'main'),以及`prefix`(是否在返回值中包含'field'前缀,默认为true)。通过这个函数,可以轻松获取如`zs`字段的ID。 2. `getFieldValue`用于获取特定字段的值,需要提供字段标示`fieldMark`,格式为`field${字段ID}_${明细行号}`,例如获取`field110`的值。 3. `changeFieldValue`接口允许开发者修改字段值,同时也能够自动触发联动效果。它需要`fieldMark`(同上)和`valueInfo`(一个JSON对象,包含待修改的值和其他信息,如对于只读文本字段的`showhtml`属性)。 这些接口的灵活运用,极大地简化了E9表单的开发过程,提高了代码的维护性和效率。通过理解并熟练掌握`ModeForm`提供的各种API,开发者可以在OA开发中实现更加智能化和用户友好的交互体验。