步骤条与标签页需分离控制逻辑并显式关联:用data-step和data-tab双属性绑定,校验前置条件后再切换,同步URL状态,SSR时预渲染正确class。

步骤条和标签页混用时,状态同步最容易断链
步骤条(step bar)和标签页(tab)看似都能“分步展示”,但语义和控制逻辑完全不同。步骤条强调线性流程与完成状态(如 1→2→3),标签页强调并行切换(如 A/B/C 任意跳)。强行把两者绑死——比如“点了步骤2就自动切到tab2”——会导致用户无法回退、URL不更新、键盘导航失效。真实项目里,步骤条应只反映当前进度,切换仍由 tab 控制,或反过来:tab 切换后主动更新步骤条的 data-step 状态。
用 data-step 和 data-tab 双属性维持顺序一致性
不要依赖 DOM 顺序或索引值来匹配步骤和面板,那太脆弱。每个步骤按钮和对应 tab 面板都必须显式声明关联关系:
- 步骤按钮写
data-step="2"和data-tab="payment" - 对应 tab 面板写
id="payment"和data-step="2" - JS 切换时,先查
document.querySelector('[data-tab="' + targetTabId + '"]'),再查它是否满足dataset.step === currentStep,不满足就拒绝切换(防越级) - 步骤条高亮靠 class:
.step.active表示已到达,.step.completed表示已提交,不能全靠.active一锅烩
点击步骤按钮时,别直接 show/hide,先校验前置条件
步骤条的本质是流程控制,不是视觉切换。用户点“下一步”按钮,你得判断:
- 当前 tab 是否已通过表单验证?检查
form.checkValidity()或自定义规则 - 是否有未保存的变更?可加
beforeunload提示,或禁用按钮直到input事件触发保存标记 - 目标步骤是否允许跳转?比如支付页(step 3)不能在地址未填(step 1)时直接激活,需提前设
data-allowed="1,2" - 校验失败时,聚焦第一个错误字段,而不是静默卡住——否则用户以为按钮没反应
URL hash 同步和 history.pushState 容易漏掉步骤状态
用户刷新页面或分享链接时,只靠 window.location.hash 恢复 tab 是不够的。步骤条的完成态(completed)、禁用态(disabled)、当前步(active)都得从 URL 或服务端初始数据还原:
立即学习“前端免费学习笔记(深入)”;
- 推荐 URL 格式:
#step=2&tab=shipping,用new URLSearchParams(window.location.hash.slice(1))解析 - 不要在
hashchange里只改 tab,要同时更新步骤条的 class 和aria-current属性 - 调用
history.pushState()时,必须传入完整状态对象,包含step、tab、valid字段,方便后续调试 - SSR 页面首次渲染时,服务端应输出对应
data-step="2" class="step completed",避免 JS 注入前出现状态闪烁



















