E9表单建模前端接口API.pdf

E9表单建模前端接口API是用于构建和操作E9系统中表单的重要工具，主要分为两个部分：卡片form的接口和查询列表的接口。这些接口被封装在一个全局对象`window.ModeForm`中，目的是为了提供统一的操作方式，推荐使用API进行表单交互，而避免使用jQuery或者原生JavaScript直接操作DOM，以保持代码的简洁和高效。 1. **全局对象window.ModeForm** - `ModeForm`是E9系统中提供的一个全局对象，它包含了所有与表单建模相关的API接口，使得开发者能够方便地进行表单的创建、数据获取、更新以及属性设置等操作。 2. **常用基础操作接口** - **转换字段名称为字段ID** (`convertFieldNameToId`) - 此方法用于将字段的名称转换为对应的ID，便于在不同的表单和环境中通用。它接受三个参数：字段名称、表单标识（默认为主表`main`）和是否需要`field`字符串前缀（默认为`true`）。 - 示例：`var fieldid = ModeForm.convertFieldNameToId("zs");` - **获取单个字段值** (`getFieldValue`) - 这个接口用于获取特定字段的值，其参数为字段标示，格式为`field${字段ID}_${明细行号}`。 - 示例：`var fieldvalue = ModeForm.getFieldValue("field110");` - **修改单个字段值** (`changeFieldValue`) - 修改字段值的同时，如果该字段涉及联动逻辑，此方法会自动触发联动更新。参数包括字段标示和一个包含新值的对象，对于浏览按钮字段，还需要特殊对象信息。 - 示例： ```javascript ModeForm.changeFieldValue("field11_2", { value: "2,3", specialobj: [ {id: "2", name: "张三"}, {id: "3", name: "李四"} ] }); ``` - **改变单个字段显示属性** (`changeFieldAttr`) - 这个接口用于改变字段的显示状态，如只读、可编辑、必填或隐藏。参数包括字段标示和一个整数值，表示所需改变的状态。 - 示例：`ModeForm.changeFieldAttr("field110", 1); // 字段改为只读` - **同时修改字段的值和显示属性** (`changeSingleField`) - 这个接口允许同时更新字段的值和显示属性，接受字段标示、新值信息和属性变更信息作为参数。 - 示例：`ModeForm.changeSingleField("field110", {value: "修改的值"}, {viewAttr: "1"}); // 修改值并置为只读` - **批量修改字段值或显示属性** (`changeMoreField`) - 批量操作接口，用于同时修改多个字段的值或属性。它接受两个JSON对象，分别表示字段值信息集合和字段显示属性集合。 - 示例： ```javascript ModeForm.changeMoreField({ field110: {val: "新值1"}, field111: {val: "新值2"} }, { field110: {viewAttr: 1}, field111: {viewAttr: 2} }); ``` 通过以上这些接口，开发者可以方便地处理E9表单中的各种交互需求，无论是单个字段的操作还是批量操作，都能够实现灵活且高效的数据管理。此外，由于E9系统采用了单页模式，使用这些API能够更好地适应页面动态更新的需求，确保表单的实时性和用户体验。