在码上飞平台实现分步表单需用多空白页面+全局变量/本地存储共享数据+手动导航控制,禁用表单页面、关闭提交前校验、添加防重复提交与自动保存逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在码上飞平台中制作分步填写表单,需绕过默认的单页表单逻辑,通过页面拆分+状态传递+流程控制三者协同实现,否则用户将无法在中途保存、无法回退校验、无法按业务阶段分层收集数据。
明确多步表单的本质结构
码上飞不提供“多步表单”控件,但支持多页面应用。真正的多步表单 = 多个独立页面 + 共享数据源 + 手动控制导航逻辑。必须用「应用页面」代替「表单设计」入口,否则后续所有步骤都会失效。
【页面类型选错将导致无法跨页传值】 进入应用后台后,点击左上角「+新建页面」→ 选择「空白页面」而非「表单页面」;若误选「表单页面」,该页将被锁定为单页提交模式,无法添加下一步按钮或跳转逻辑。
搭建分步页面骨架
以「客户信息采集」为例,共3步:基础信息→联系方式→确认提交。
第一步:新建3个空白页面,分别命名为「step1_基础信息」「step2_联系方式」「step3_确认提交」;命名必须含序号且无空格,否则后续路由跳转会失败。
第二步:在每个页面顶部拖入「标题」控件,内容对应写明“第1步:基础信息”等;这一步不是装饰,而是为后续AI生成导航文案提供上下文锚点。
第三步:进入「step1_基础信息」页面,在画布中拖入「单行输入」控件(姓名)、「日期选择」(出生日期)、「下拉选择」(性别);注意暂不设置“必填”,验证逻辑统一放在最后一步做,避免用户卡在第一步无法前进。
配置跨页数据共享
方法一:使用全局变量(推荐新手)
在应用设置 →「变量管理」中新建一个对象型变量,名称设为「formData」,初始值为空对象 {};所有页面都可通过 {{formData.name}} 读写该变量字段,无需额外配置。
方法二:使用本地存储(适合需离线续填场景)
在每个页面的「页面加载时」事件中添加代码块:
if (localStorage.getItem('formData')) { $set('formData', JSON.parse(localStorage.getItem('formData'))); }
在每个页面的「下一步」按钮点击事件末尾添加:
localStorage.setItem('formData', JSON.stringify($get('formData')));
此方式可防止用户刷新页面后数据丢失,但需手动清理过期数据。
注意:两种方式不可混用,否则会出现数据覆盖冲突。
添加带状态控制的导航按钮
第一步:在「step1_基础信息」页面底部拖入「按钮」控件,文字设为「下一步」;点击事件选择「跳转页面」→ 目标页选「step2_联系方式」。
第二步:在「step2_联系方式」页面底部放两个按钮:左侧「上一步」跳转回「step1_基础信息」,右侧「下一步」跳转至「step3_确认提交」;两个按钮均需绑定「页面跳转」动作,不能用「提交表单」——后者会强制清空未提交页面的数据。
第三步:在「step3_确认提交」页面,拖入「文本显示」控件,内容设为 {{formData.name}}、{{formData.phone}} 等,用于预览全部已填内容;再拖一个「提交按钮」,点击事件选择「调用API」→ 选择已配置好的后端接口,或使用内置「保存到数据库」动作。
关键细节:所有「上一步」「下一步」按钮都必须关闭「提交前校验」开关,否则点击时会触发全字段验证,导致用户无法从第二步返回修改第一步内容。
注入自动保存与防重复提交逻辑
① 在每个页面的「页面卸载前」事件中插入代码:
if ($get('formData')) { localStorage.setItem('formData', JSON.stringify($get('formData'))); }
这能捕获用户意外关闭标签页的行为,保留当前进度。
② 在「step3_确认提交」页面的提交按钮点击事件最开头插入判断:
if ($get('isSubmitting')) { return; } $set('isSubmitting', true);
并在提交成功回调末尾加 $set('isSubmitting', false);否则用户手速快连点两次,后端会收到重复订单。
③ 提交成功后跳转至「提交成功」页面,该页面需包含「清空localStorage.formData」动作,防止用户返回继续填写时复用旧数据。


















