手动提交表单

不依赖表单内置提交按钮时，可通过表单 API 的 submit 方法主动发起提交：先走校验，通过后汇总表单数据并触发全局 onSubmit 钩子（若已配置），与点击默认提交按钮效果一致。

注意

使用 api.submit() 手动提交时，建议留意以下几点：

1. 隐藏内置提交按钮：若改用页面上自己的按钮调用 api.submit()，通常应在表单 option 中将 submitBtn 设为 false（必要时同时关闭 resetBtn），避免与自定义按钮重复。

2. 校验与失败处理：submit 会先执行校验；未通过时走第二个参数 fail 回调（若传入）。使用 submit().then(...) 时，请以当前所用版本行为为准，失败场景可优先配合 fail 回调处理。

3. 与 submit 事件的关系：手动调用 api.submit() 与点击内置提交按钮一样，会触发表单 submit 事件（如在组件上 @submit 或通过 api.on('submit', ...) 监听）。