iter(g327): stepper 补失败态与整条回跳

2026-10-27 01:56:10 +08:00
parent 8d154daa6a
commit 0a5665e296
8 changed files with 79 additions and 18 deletions
@@ -1397,7 +1397,12 @@
            "n": "steps",
            "t": "StepperItem[]",
            "r": 1,
-            "d": "步骤列表，每项 { label, description? }"
+            "d": "步骤列表，每项 { label, description?, status? }"
+          },
+          {
+            "n": "status",
+            "t": "'error'",
+            "d": "写在 steps 的每一项里：该项标为失败（红点 + 感叹号 + 读屏「第 N 步：xx（失败）」），优先级高于进度态，也不参与回跳"
          },
          {
            "n": "active",
@@ -1427,7 +1432,8 @@
        "steps": [
          "用 signal(0) 创建当前步索引，传入 active；索引之前的步骤显示 ✓ 已完成态",
          "流程推进时外部赋值即可：step(step() + 1)，组件三态自动跟随",
-          "clickable: true 时已完成步骤可点击回跳并写回信号，配合 onChange 同步业务状态",
+          "clickable: true 时已完成步骤可点击回跳并写回信号，配合 onChange 同步业务状态；点圆点（键盘可 Tab）或标题文字都算，一次点击只回调一次",
+          "某步失败时给该项加 status: 'error'：圆点变红加感叹号、标题标红、读屏读「第 N 步：xx（失败）」；它既不进 done 也不占 current，因此不参与回跳——「失败」和「还没走到」只能是两种视觉",
          "侧栏或移动端传 direction: 'vertical'：圆点成一列、说明文字紧贴右侧，步与步之间由圆点下方的竖线相连（末步不画线，已完成的段用主色标进度）"
        ]
      },