iter(g280): 表单项支持条件显示

2026-10-26 23:06:21 +08:00
parent 802dbabe05
commit 865477c37f
5 changed files with 24 additions and 5 deletions
@@ -1859,6 +1859,11 @@
            "t": "number",
            "d": "多列表单里本字段占几列（如整宽的多行备注）；单列布局或窄屏下自动退回整行"
          },
+          {
+            "n": "（formItem）visible",
+            "t": "Signal<boolean>",
+            "d": "条件显示信号：为假时整项隐藏且不参与校验（未显示的字段不该拦住提交）"
+          },
          {
            "n": "onReset",
            "t": "() => void",
@@ -1891,7 +1896,8 @@
          "formItem 返回 { el, validate, validateAsync } 句柄：validate 只跑同步规则（供 blur/input 即时反馈），validateAsync 逐条 await 供 form 聚合提交",
          "需要给字段加格式说明就传 hint：平时显示在控件下方，校验失败时自动让位给错误文案，同一位置不堆两行",
          "字段多的编辑页传 columns: 2 或 3 走多列栅格：列间距与窄屏堆叠沿用 grid，按钮区始终整行；单列表单不要传（默认 1）",
-          "多列表单里想整宽就传 span：formItem({ span: 2 }, textarea(...)) 会占满两列，窄屏单列时自动忽略跨列（否则会撑出横向滚动）"
+          "多列表单里想整宽就传 span：formItem({ span: 2 }, textarea(...)) 会占满两列，窄屏单列时自动忽略跨列（否则会撑出横向滚动）",
+          "字段要按另一个字段的值决定是否出现（选了「其他」才出现输入框），给 formItem 传 visible 信号：隐藏项自动清掉错误态并退出校验，不用自己在 items 数组里增删"
        ]
      },
      {