E9表单API:自定义代理渲染与单行文本框事件绑定

需积分: 44 7 下载量 143 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
"自定义代理渲染单行文本框字段-Cisco中型项目实战" 在Cisco的中型项目实战中,我们关注的是如何通过E9API在泛微OA系统中进行自定义代理渲染单行文本框字段的操作。这个过程涉及到E9表单建模前端接口API的使用,这些接口被封装在全局对象`window.ModeForm`中,以提供对表单的控制和交互。 1. **事件绑定** - **字段区域绑定动作事件**:在最低版本KB900190800及以上,推荐使用值变化事件来实现开发,因为这些事件不仅针对字段元素,而且是字段所在单元格区域触发。例如,可以绑定`onblur`(失去焦点)、`onfocus`(获取焦点)、`onclick`(单击)、`ondblclick`(双击)、`mouseover`(鼠标移入)和`mouseout`(鼠标移出)等事件。这些事件适用于单行文本字段类型,并且参数包括事件类型、字段ID和行号,便于在触发时执行相应的处理函数。 - **样例代码**:展示了如何使用`bindFieldAction`方法绑定不同的事件。例如,当`onfocus`事件触发时,特定字段会打印相关信息;而`onclick`事件则适用于整个字段所在单元格区域的单击事件。 2. **E9API基础操作接口** - **字段名称转ID**:`convertFieldNameToId`函数用于将字段名称转换为字段ID,可以适应多表单和多环境。它接受字段名称、表单标识(默认为主表`main`)和是否需要前缀(默认为`true`)作为参数。 - **获取单子字段值**:`getFieldValue`函数通过字段标记(`field${字段ID}_${明细行号}`)获取字段的值。 - **修改单个字段值**:`changeFieldValue`方法用于更新字段的值,如果字段涉及联动,修改后会自动触发联动。它需要字段标记和一个包含新值的对象(对于浏览按钮字段,可能还需要特殊对象和`showhtml`属性)。 3. **E9API设计原则** - **单页模式**:E9系统采用单页模式,推荐使用API接口而非jQuery操作,原生JS操作DOM是禁止的。 4. **自定义代理渲染** - **单行文本框字段**:在12.2部分,详细讲解了如何自定义代理渲染单行文本框字段,这可能涉及到对字段的显示方式、交互逻辑或者样式等方面的定制,以满足特定业务需求。 自定义代理渲染单行文本框字段是泛微OA中型项目中的一个重要环节,它涵盖了事件监听、字段值的获取与修改以及API接口的灵活应用。开发者需要理解并熟练掌握`window.ModeForm`对象提供的接口,以实现高效且符合规范的表单功能定制。