SuperAPI AI 工具集

netlify-forms

前端与建站

查看项目

更新于 10-16 03:47

技能介绍

用途:在 Netlify 托管站点上实现无服务器表单处理。部署时解析最终构建的 HTML 检测表单,无需运行时 API 或后端代码,提交内容由 Netlify 存储、过滤垃圾信息并发送通知。

主要能力:静态 HTML 表单在 <form> 上添加 data-netlify="true"(或 netlify 属性)即可被检测;部署时会移除该属性并注入隐藏的 form-name 输入。支持自定义成功页面、文件上传、Akismet 垃圾过滤、蜜罐字段、Netlify reCAPTCHA 2 与自定义 reCAPTCHA 2、邮件/Webhook/Slack 通知,以及通过 API 读取提交。

使用方式:需先在 Netlify UI 的 Forms 中启用表单检测,下次部署生效。JS 渲染/SSR/框架表单不会被自动检测,需在 public/__forms.html 放置静态骨架文件(含 data-netlify="true"、隐藏 form-name 及与组件提交完全同名的字段),否则提交会静默失败。SSR 应用应 POST 到骨架文件而非 /。AJAX 提交时请求体必须 URL 编码,不支持 JSON;文件上传不要手动设置 Content-Type。自定义成功页使用无扩展名路径(如 /thank-you)。

适用场景:Netlify 站点上的联系表单、订单表单等需要收集提交并通知的场景。

限制:删除表单不可恢复,未来提交返回 404,历史提交不可用,需先导出 CSV;文件上传每字段一个文件、请求最大 8 MB、上传超时 30 秒;提交代码会被转义;数据仅能通过 UI/API/CSV 访问;PII 需定期导出删除。缺失的合法提交通常是 Akismet 误判,应先检查垃圾列表。