E9表单建模前端接口API操作指南

"本文档主要介绍了在cisco中型项目实战中使用JavaScript进行原生操作的相关知识点，包括明细新增行和删除行的触发事件、jQuery与JS原生操作的使用建议，以及E9表单建模前端接口API的常用基础操作。" 在“JS原生操作-cisco 中型项目实战”中，有以下几个重要的知识点： 1. **明细新增行渲染后触发事件**： - 当新增行（无论是手动、联动还是接口添加）完成后，会触发 `_customAddFun` 函数，该函数会根据`groupid`进行重载，`groupid`从1开始递增。例如，`_customAddFun1` 代表明细1的新增事件。这个方法内部可以获取到新增行的DOM结构，并通过`addIndexStr`参数获取新增行的标识串。如果联动一次性增加多行，该方法只会触发一次，`addIndexStr`会包含所有新增行的行标识，用逗号分隔。 2. **明细删除行渲染后触发事件**： - 删除行（不论是手动删除还是接口删除）后，会触发 `_customDelFun` 函数，同样按照`groupid`进行重载。例如，`_customDelFun1` 代表明细1的删除事件。当删除成功时，会打印“删除明细”的日志。 3. **jQuery操作的不推荐使用**： - 虽然之前可能习惯于使用jQuery操作DOM，但在E9项目中，不再推荐这种做法，因为这可能导致兼容性问题。 4. **JS原生操作的禁止**： - 直接使用原生JS操作DOM，如 `document.write()` 和 `document.getElementById().value` 等，是被禁止的。这些操作可能会引发不可控的异常。推荐使用 `ModeForm` 接口进行操作。 5. **E9表单建模前端接口API**： - 这些接口统一封装在全局对象 `window.ModeForm` 中，适用于E9的单页应用模式。为了保持代码的稳定性和兼容性，建议使用API而非jQuery或原生JS操作。 6. **常用基础操作接口**： - 包括了将字段名称转换成字段id的方法 `convertFieldNameToId`，它可以帮助解耦代码，提高代码的复用性。 - 获取单个字段值的方法 `getFieldValue`，通过字段标示可以获取字段的当前值。 - 修改单个字段值的方法 `changeFieldValue`，修改后会自动触发关联的联动效果。对于只读的文本字段，可以设置`showhtml`属性来控制显示的HTML内容。 在进行E9表单建模的开发时，应当遵循这些最佳实践，使用提供的API进行操作，以确保代码的稳定性和项目的顺利进行。同时，注意避免使用可能导致问题的原生DOM操作和过时的jQuery方法。