用户在前端表单点提交,页面刷一下,返回时所有输入框都空了。这是传统表单最恼人的体验,尤其是长表单,填到一半被清空,用户直接走人。
改成异步提交不算难,难的是把校验、防重复提交、错误提示、成功之后的跳转一次性处理对。我上周给一个客户的后台加了个留言表单,用 fetch 重写,代码贴出来,可以直接照搬。
HTML 部分:先禁掉默认提交
<form id="msgForm" action="/api/message.php" method="post">
<input name="nickname" maxlength="20" required>
<textarea name="content" rows="5" required></textarea>
<span id="tip"></span>
<button type="submit" id="submitBtn">提交</button></form>
按钮用 type="submit",不要 type="button",这样回车键也能提交,体验才对。
JS 部分:完整的一套流程
document.getElementById('msgForm').addEventListener('submit', async function (e) {
e.preventDefault(); const btn = document.getElementById('submitBtn'); const tip = document.getElementById('tip'); if (btn.disabled) return;
btn.disabled = true; const old = btn.textContent;
btn.textContent = '提交中…'; try { const res = await fetch(this.action, { method: 'POST', body: new FormData(this), credentials: 'same-origin'
}); let data; try {
data = await res.json();
} catch (err) { throw new Error('服务器返回格式异常');
} if (res.ok && data.code === 0) {
tip.textContent = '提交成功';
tip.style.color = '#0a7d55'; this.reset();
} else {
tip.textContent = data.msg || '提交失败';
tip.style.color = '#c0392b';
}
} catch (err) {
tip.textContent = '网络异常,请稍后再试';
tip.style.color = '#c0392b';
} finally {
btn.disabled = false;
btn.textContent = old;
}
});
几个细节值得说清:
e.preventDefault() 必须放在第一行,否则表单会照常提交,页面还是刷新。- 按钮禁用是防重复提交最省事的办法,比后端加锁简单,两者一起用更稳。
finally 里一定要恢复按钮,不然出一次错用户就再也点不动了。credentials: 'same-origin' 保证同域请求会带上 Cookie,需要登录态的表单必须加。
后端的约定比前端更重要
前端代码再漂亮,后端如果返回 HTML 错误页,res.json() 就解析失败。我建议统一约定:任何接口,不管成功失败,一律返回 JSON。
header('Content-Type: application/json; charset=utf-8');$nickname = trim($_POST['nickname'] ?? '');if ($nickname === '' || mb_strlen($nickname) > 20) { exit(json_encode(['code' => 1, 'msg' => '昵称不能为空且不超过 20 字'], JSON_UNESCAPED_UNICODE));
}exit(json_encode(['code' => 0, 'msg' => 'ok'], JSON_UNESCAPED_UNICODE));
JSON_UNESCAPED_UNICODE 这面,不加的话中文会变成 \u 编码,日志里没法排查。
表单提交之后常被忽略的两件事
防刷。 匿名表单没有验证,一分钟能刷几十条。最简单的做法是加一个隐藏的时间戳字段,后端比对提交间隔小于 3 秒就拒绝,再加上同 IP 的频次限制。
错误定位。 用户填错了一项,最好在对应输入框旁边提示,而不是只在底部给一句笼统的"提交失败"。给每个字段留一个 <span> 放提示,体验立刻不一样。
改完之后最直观的变化是:用户提交成功,页面不跳,输入框清空,底部出现一行绿字。就这一个小改动,那个站的留言量翻了将近一倍——原来很多人以为提交失败了。