vue-hook-form

用于处理form请求，获取formData。以便于将form请求转成ajax/fetch请求

安装

npm install vue-hook-form

使用

VUE版本：1.x
必须在vue-cli生成的webpack模板环境中使用

一，注册&配置组件

// 这里使用在main.js中全局注册来示例
import vue from 'vue'
import hookForm from 'vue-hook-form'
// 配置全局form表单序列化之前的hook
hookForm.beforeSerialize = (vm, next) => {
  // vm: 对应的hookForm vm实例
  // next：继续执行
  // 你可以在此处执行表单校验
}
// 配置全局form提交前的hook
hookForm.onSubmit = request => {
  // request：包含了本次请求的基本信息
  // 你可以在此处执行表单校验或使用ajax来提交本次请求
}
vue.component('hook-form', hookForm)

Request对象：

{
  url: '请求地址',
  body: '请求参数',
  method: '请求方法',
  vm: '对应的hookForm vm实例'
}

二，vue文件中使用

<template>
  <hook-form action="users" :on-submit="onSubmit" :before-serialize="beforeSerialize">
    <input name="name">
    <input name="age">
    <button>提交</button>
  </hook-form>
</template>
<script>
  export default {
    methods: {
      // 局部hook
      beforeSerialize (vm, next) {
        // next：继续执行
        // 你可以在此处执行表单校验
      },
      onSubmit (request) {
        // request：包含了本次请求的基本信息
        // 你可以在此处执行表单校验或使用ajax来提交本次请求
      }
    }
  }
</script>

配置

onSubmit

form提交前的全局hook。参见上文注册&配置组件

beforeSerialize

form表单序列化之前的全局hook。参见上文注册&配置组件
一般用于校验表单，但此时无须form表单序列化的时候。也便于在触发onSubmit之前更改form表单内容

json

Request.body是否转成json格式，默认为url字符串。默认：false

hookForm.onSubmit = request => {
  // request.body为url字符串格式
  // 形如：name=张三&age=18
}
// 配置Request.body为json格式
hookForm.json = true
hookForm.onSubmit = request => {
  // request.body为json格式
}

Props

• action：请求地址
• method：请求方法。默认：post
• onSubmit：form提交前的局部hook
• beforeSerialize: form表单序列化之前的局部hook
• json：Request.body是否转成json格式（优先使用局部json配置）。默认：false
• disabled：禁用

关于disabled

你可以通过使用该选项来防止form的多次提交

hookForm.onSubmit = request => {
  // 禁止form提交
  request.vm.disabled = true
  // 在ajax请求或其他相关操作之后再释放禁用。
  doSomeThing()
    .then(() => {
      request.vm.disabled = false
    })
}

常见问题

全局onSubmit中提交了请求，返回了请求。这些操作如何通知到对应的组件？

Request对象中有一个vm属性，这是hookForm组件本身的vue实例。父子组件通信
也就是说hookForm只是扮演form和ajax之间的桥梁，负责传送一下form表单数据。你可以基于它二次封装一个更多功能的form组件

全局hook和局部hook会不会同时触发？

不会。如果存在局部hook，那么优先触发局部，否则才触发全局。