You need to enable JavaScript to run this app. 是否存在记录form.io全部事件的完整文档清单
优惠活动
大模型
产品
解决方案
定价
更多

是否存在记录form.io全部事件的完整文档清单

form.io 全量事件的获取方式

你提到的GitHub Wiki上的事件清单维护滞后、覆盖不全的问题确实存在,目前没有官方对外发布的、静态可查的全量事件文档,可通过以下几种可靠方式拿到当前使用版本下的完整事件列表:

可靠获取全量事件的方案

  • 源码回溯法(100%覆盖率):form.io的所有事件都是通过统一的事件派发API抛出的,你可以在源码库中全局搜索核心触发方法的调用位置,把对应事件名去重整理即可得到全量清单:
    • 表单实例级别的触发方法:this.emit()、this.emitAsync()
    • 组件实例向上抛给根表单的触发方法:this.root.emit()
      这种方式可以捕获所有公开、未对外公示的事件,完全不会有遗漏,是目前社区整理全量事件清单的最常用方法。
  • 运行时拦截法(完全适配本地项目版本):在本地项目的FormRenderer初始化流程中,挂载全局事件拦截逻辑,自动收集当前实例支持监听的所有事件名,示例代码如下:
const formRenderer = new FormRenderer(containerElement, renderOptions);
// 重写事件注册方法,打印所有可监听的事件名
const originalOnMethod = formRenderer.on.bind(formRenderer);
formRenderer.on = (eventName, callback) => {
  console.log('当前支持的可监听事件:', eventName);
  return originalOnMethod(eventName, callback);
};

写完这段代码后,遍历触发所有表单可交互流程,控制台输出的所有事件名集合,就是你当前项目依赖版本支持的全量事件清单。

常见注意事项

  • 事件体系和版本强绑定:form.io的不同大版本会新增、废弃部分事件,不存在一份可以通用所有版本的永久全量列表
  • 公开Wiki的事件条目更新远滞后于源码实际实现,尤其是流程触发类、错误回调类的隐式事件,基本都不会收录到公开文档中,比如formLoad、componentChange、beforeSubmit、wizardPageSwitch这类高频事件,都是开发者通过源码检索才整理出的常用事件。

提醒:不要直接套用网上流传的静态事件列表,这些列表大多是多年前旧版本整理的,和你当前使用的版本匹配度极低,很容易出现事件不存在、回调不触发的问题。

内容的提问来源于stack exchange,提问作者Alerys

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 12:36:04