iter(g296): 修正表单校验失败仍提交

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T15:31:57.268Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T15:36:58.959Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -1010,6 +1010,7 @@ const name = signal(''); const f = form({ onSubmit: submit }, [formItem({ label:
 13. 字段多的编辑页传 columns: 2 或 3 走多列栅格：列间距与窄屏堆叠沿用 grid，按钮区始终整行；单列表单不要传（默认 1）
 14. 多列表单里想整宽就传 span：formItem({ span: 2 }, textarea(...)) 会占满两列，窄屏单列时自动忽略跨列（否则会撑出横向滚动）
 15. 字段要按另一个字段的值决定是否出现（选了「其他」才出现输入框），给 formItem 传 visible 信号：隐藏项自动清掉错误态并退出校验，不用自己在 items 数组里增删
+16. 校验失败必定中止提交：判据是错误条数而不是「有没有找到焦点目标」，所以只有自绘控件（非搜索式下拉 / 评分 / 开关，容器里没有原生 input）的字段也能拦住；焦点定位顺序是控件 → 触发器 → 字段容器（后者临时 tabindex=-1，只接受程序聚焦，不污染 Tab 序）
 
 现场演示：apps/docs/demo.html#sec-formlab