本文介绍一种微信小程序离线表单提交方案，解决网络不稳定情况下用户填写表单的需求。即使在离线或网络差的情况下，用户也能填写表单，并在网络恢复后自动提交数据。
该方案的核心在于利用小程序的本地存储和网络状态监听功能。以下步骤将详细解释如何实现：
第一步：配置网络超时时间
在 app.json 中配置网络超时时间，防止网络请求长时间等待：
{
"pages": ["pages/formpage/formpage"],
"window": {
"backgroundtextstyle": "light",
"navigationbarbackgroundcolor": "#fff",
"navigationbartitletext": "离线表单",
"navigationbartextstyle": "black"
},
"networkTimeout": {
"request": 10000,
"downloadFile": 10000
},
"debug": true
}
第二步：创建表单页面 (pages/formpage/formpage.wxml)
创建一个简单的表单，例如：
第三步：实现表单数据处理 (pages/formpage/formpage.js)
在 pages/formpage/formpage.js 中，编写处理表单数据保存、网络状态检查和数据提交的逻辑：
Page({
data: {
formData: {}
},
submitform: function(e) {
const formData = e.detail.value;
this.saveFormData(formData);
this.checkNetworkAndSubmit();
},
saveFormData: function(formData) {
wx.setStorageSync('formData', formData);
},
checkNetworkAndSubmit: function() {
const that = this;
wx.getNetworkType({
success: function(res) {
if (res.networkType !== 'none') {
that.submitFormData();
} else {
console.log('网络不可用，数据已保存，等待网络恢复后自动提交');
}
}
});
},
submitFormData: function() {
const formData = wx.getStorageSync('formData');
wx.request({
url: '你的服务器接口地址',
method: 'POST',
data: formData,
success: function(res) {
console.log('提交成功');
wx.removeStorageSync('formData');
},
fail: function(res) {
console.error('提交失败', res);
// 此处可添加重试逻辑
}
});
}
});
第四步：监听网络状态变化 (app.js)
在 app.js 中监听网络状态变化，并在网络恢复时自动提交保存的表单数据：
App({
onLaunch: function() {
const that = this;
wx.onNetworkStatusChange(function(res) {
if (res.isConnected) {
const formData = wx.getStorageSync('formData');
if (formData) {
that.submitFormData(formData);
}
}
});
},
submitFormData: function(formData) {
// 与pages/formPage/formPage.js中的submitFormData函数相同
}
});
请替换 '你的服务器接口地址' 为你的实际服务器接口地址。 开发者可根据实际需求完善重试机制和错误处理。 此方案利用 wx.setStorageSync、wx.getStorageSync、wx.removeStorageSync、wx.getNetworkType 和 wx.onNetworkStatusChange 实现本地存储和网络状态监听。
