在 Vue 应用中使用 Netlify 表单功能的方法详解

2019-11-19 11:24:34

字体：大中小

来源：转载

供稿：网友

Netlify 带有内置表单处理功能，可以用来存储表单数据，下载 csv 文件，同时可以在接收到新的提交时发送邮件通知或者通过配置 webhook 发送请求。

它是通过在部署应用时直接解析 HTML 文件，识别 html 中的 form 标签来实现的，本文记录如何在一个 Vue 应用中使用表单功能。

开发

首先使用@vue/cli 新建一个 Vue 应用，完成一系列步骤后，运行应用

vue create my-awesome-app...yarn serve

创建一个 form 表单

<!-- data-netlify="true" 表明使用 form 功能 netlify-honeypot="bot-field" 指定机器人识别字段 --><template> <form id="app" method="POST" name="contact" data-netlify="true" netlify-honeypot="bot-field" @submit.prevent="handleSubmit" > <input name="bot-field" hidden> <label for="username">  用户名：  <input  type="text"  id="username"  placeholder="请输入你的用户名"  name="username"  v-model="form.username"  > </label> <label for="email">  邮箱：  <input type="email" id="email" placeholder="请输入你的邮箱" name="email" v-model="form.email"> </label> <button type="submit">Submit</button> </form></template>

注意应用的根节点一定要保留 id=''app" 属性，否则经过静态化之后页面上绑定的事件会失效

在 form 标签上监听 submit 事件，并且阻止浏览器默认事件，使用 axios 提交 post 请求

yarn add axios

handleSubmit() { axios .post(  "/",  this.encode({  "form-name": "contact", // 请求数据一定要加上 form-name 属性  ...this.form  }),  {  header: { "Content-Type": "application/x-www-form-urlencoded" }  } ) .then(() => {  alert("提交成功"); }) .catch(() => {  alert("提交失败"); });}

安装预渲染插件 prerender-spa-plugin github.com/chrisvfritz… ，作用是静态化 Vue 应用，一定要预渲染 Vue 应用，因为如果是通过 js 渲染的页面， Netlify 是解析不到 form 表单的

yarn add prerender-spa-plugin --dev

新建一个 vue.config.js 文件用来扩展 webpack 配置

const path = require('path')const PrerenderSPAPlugin = require('prerender-spa-plugin')module.exports = { configureWebpack: () => { if (process.env.NODE_ENV !== 'production') return return {  plugins: [  new PrerenderSPAPlugin({   staticDir: path.join(__dirname, 'dist'),   routes: ['/']  })  ] } }}

完整代码如下

<template> <!-- data-netlify="true" 表明使用 form 功能 netlify-honeypot="bot-field" 指定机器人识别字段 --> <form id="app" method="POST" name="contact" data-netlify="true" netlify-honeypot="bot-field" @submit.prevent="handleSubmit" > <input name="bot-field" hidden> <label for="username">  用户名：  <input  type="text"  id="username"  placeholder="请输入你的用户名"  name="username"  v-model="form.username"  > </label> <label for="email">  邮箱：  <input type="email" id="email" placeholder="请输入你的邮箱" name="email" v-model="form.email"> </label> <button type="submit">Submit</button> </form></template><script>import axios from "axios";export default { name: "app", data() { return {  form: {  username: "",  email: ""  } }; }, methods: { encode(data) {  return Object.keys(data)  .map(   key => `${encodeURIComponent(key)}=${encodeURIComponent(data[key])}`  )  .join("&"); }, handleSubmit() {  axios  .post(   "/",   this.encode({   "form-name": "contact",   ...this.form   }),   {   header: { "Content-Type": "application/x-www-form-urlencoded" }   }  )  .then(() => {   alert("提交成功");  })  .catch(() => {   alert("提交失败");  }); } }};</script><style>#app { font-family: "Avenir", Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; text-align: center; color: #2c3e50; margin-top: 60px;}label { display: block;}</style>

部署

在 Github 上新建一个仓库，上传代码，之后在 Netlify 上点击 New site form Git，进行授权，完成授权后选择要部署的项目仓库