---
name: e10-form-jsapi
description: Use when E10 前端任务涉及表单引擎 JSSDK、表单代码块、formSdk/WeFormSDK、字段取值赋值、字段属性、事件注册、明细表、浏览按钮、容器字段、插件字段、提交拦截或表单校验。
---

# E10 表单引擎 JSSDK

表单实例、字段操作、事件注册、明细表、全局操作、特定字段类型、容器字段、插件字段和案例参考。

## 工作流程

1. 先确认页面类型和目标业务动作，避免混用不同页面 SDK。
2. 在原始文档中检索 API、常量名或业务词，只读取命中段落附近内容：

```bash
rg -n "formSdk|WeFormSDK|getFieldValue|changeFieldValue|registerCheckEvent|registerAction|getDetailData|changeDetailData|proxyFieldComp|pluginExecute|明细|浏览按钮|表单" skills/e10-local-knowledge/modules/e10-form-jsapi/references/form-jsapi.md
```

3. 根据命中标题读取参数、返回值、调用时机和完整示例。未在文档出现的 API 不得猜测。
4. 实现时保留原页面行为、PC/移动端边界、登录态、租户和权限约束。
5. 验证目标页面、动作时机、异常分支和重复注册/解绑行为。

## 强制规则

- 原始 API 证据来自新版全量 [form-jsapi.md](references/form-jsapi.md)。
- 优先使用文档中的 `formSdk`/`window.WeFormSDK.getWeFormInstance()` 获取方式和示例调用顺序。
- 全局对象可能尚未加载时，先做存在性检查或按文档要求等待。
- 注册事件、拦截器或字段复写时，确认动作常量、字段标识、触发范围和重复注册影响。
- 不得因示例使用全局对象而绕过 e-code 请求准入、安全或权限规则。
- 输出实际命中的标题/API、实现位置与验证结果。
- 表单刷新、保存或弹窗切换后，重新获取当前实例，不长期缓存全局实例。
- 明细字段必须先确认 `detailMark`、字段 dataKey 和行后缀；主表与明细同名字段需显式指定 `symbol`。
- 表单页面等待文档指定 ready 回调，例如 `formReady` 或全局初始化完成回调；不得用固定延时替代生命周期。
