首页网站问题文章详细

表单提交后数据全丢?用 fetch 改造的几个关键点

原创2026-11-08 12:07:37 62

用户在前端表单点提交,页面刷一下,返回时所有输入框都空了。这是传统表单最恼人的体验,尤其是长表单,填到一半被清空,用户直接走人。

改成异步提交不算难,难的是把校验、防重复提交、错误提示、成功之后的跳转一次性处理对。我上周给一个客户的后台加了个留言表单,用 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> 放提示,体验立刻不一样。

改完之后最直观的变化是:用户提交成功,页面不跳,输入框清空,底部出现一行绿字。就这一个小改动,那个站的留言量翻了将近一倍——原来很多人以为提交失败了。


快审推荐