1.0.3 • Published 3 years ago

le-form v1.0.3

Weekly downloads
9
License
MIT
Repository
github
Last release
3 years ago

le-form

基于element-ui 的form表单实现的一个高拓展性的表格布局组件,能够用于日常使用表单的布局实现。

功能说明

  • 栅格化布局
  • 表单数据绑定
  • 表单验证
  • 表格高度会根据内容高度自动产生变化

前置条件

需要先全局注册element-ui的el-form、el-form-item、el-tooltip三个组件

安装

npm install le-form --save
Or
yarn add le-form

使用

<form-container class="form"  ref="form" labelWidth="72" :model="model" :rules="rules">
  <form-item label="表单项1" prop="one">
    <el-input v-model="model.one" placeholder="请输入"></el-input>
  </form-item>
  <form-item label="表单项2" prop="two">
    <el-input v-model="model.two" placeholder="请输入"></el-input>
  </form-item>
  <form-item label="表单项3" prop="three">
    <el-input v-model="model.three" placeholder="请输入"></el-input>
  </form-item>
  <form-item label="表单项4" prop="four" inline span="12">
    <el-input v-model="model.four" placeholder="请输入"></el-input>
  </form-item>
  <form-item label="表单项5" prop="five" inline span="12">
    <el-input v-model="model.five" placeholder="请输入"></el-input>
  </form-item>
</form-container>
// 配置element的展示
Vue.prototype.$ELEMENT = { size: 'small', zIndex: 3000 };

var app = new Vue({
  el: '#app',
  data() {
    return {
      model: {
        one: '',
        two: '',
        three: '',
        four: '',
        five: '',
      },
      rules: {
        one: [
          { required: true, message: '请填写', trigger: 'blur' },
        ],
      },
    };
  },
});

效果展示

image

文档

FormContainer (表单容器)

model和rules的使用方法与element-ui的form组件一致

FormContainer Attributes

参数说明类型可选值默认值
labelWidthlable宽度number/string————
model表单数据对象object————
rules表单验证规则object————

FormContainer Methods

方法名说明参数
validate对整个表单进行校验的方法,参数为一个回调函数Function(callback: Function(boolean, object))

FormTitle (表单标题)

FormTitle Slot

name说明
——FormTitle内容

FormItem (表单项)

FormItem Attributes

参数说明类型可选值默认值
label标签文本string————
inline是否级联显示boolean——false
span所占24列中的多少份number/string——24
prop表单域 model 字段,在使用 validate方法的情况下,该属性是必填的string传入 Form 组件的 model 中的字段——
heightformItem的高度number/string————
alignTop内容区是否从顶部开始布局,默认垂直居中boolean——false
noPadding是否有内边距boolean-false

FormItem Slot

name说明
——FormItem内容