# 插件

插件只是简单的函数,可以访问 Vue Formulate 实例并可以扩展它。如果您想编写自己的自定义 验证规则消息表单域,这将非常有用 。

# 社区插件

这是社区创建的插件的简短列表, 通过 编辑此页面(英文)(opens new window) 将您自己的插件添加到此列表:

# 创建一个新插件

插件只是在注册时传递给 Vue Formulate 并在实例化时调用的函数。

# 简单例子

import Vue from 'vue'
import VueFormulate from '@braid/vue-formulate'

// 我们的第一个插件
function myFirstPlugin (instance) {
  // 添加一个新的验证规则
  instance.extend({
    rules: {
      foobar: ({ value }) => ['foo', 'bar'].includes(value)
    }
  })
}

Vue.use(VueFormulate, {
  plugins: [ myFirstPlugin ]
})

#extend 方法

传递给 Vue Formulate 插件的参数是一个包含 extend 的实例,这个方法可以递归地扩展实例配置选项。这可用于覆盖和添加任何配置选项。

# 示例自动完成插件

插件的一个常见用例是复用自定义表单域,因此作为示例,让我们创建一个插件, 该插件公开来自 自定义输入文档页面 的自动完成表单域

// 文件: Autocomplete.js
import MyFormulateAutocomplete from './components/MyFormulateAutocomplete'

export default function (formulateInstance) {
  formulateInstance.extend({
    components: {
      MyFormulateAutocomplete
    },
    library: {
      autocomplete: {
        classification: 'text',
        component: 'MyFormulateAutocomplete'
      }
    }
  })
}

提示

在上面的代码中,我们使用 Vue Formate 通过将组件添加到 components 对象来注册我们的组件。 这很方便,但您不需要向 Vue Formulate 注册组件,只要它是全局注册的。

// index.js (or where you add your vue plugins)
import Vue from 'vue'
import VueFormulate from '@braid/vue-formulate'
import Autocomplete from './Autocomplete'

Vue.use(VueFormulate, {
  plugins: [ Autocomplete ]
})

当然,上面的代码也可以打包成一个整洁的 npm 包发布给公众使用。