首页 > 其他 > 详细

💡我们的表单解决方案 el-form-renderer

时间:2019-07-26 17:09:08      阅读:78      评论:0      收藏:0      [点我收藏+]

前言

本文将介绍我们的表单解决方案?@femessage/el-form-renderer,展示我们在?Vue?技术栈下,我们是如何处理以下问题的:

  • 表单项动态显示或隐藏
  • 表单数据联动
  • 表单输入/输出数据格式化
  • 非常规表单项的处理
  • 复杂的表单验证

方案

表单项动态显示或隐藏(hidden)

可以通过?hidden?控制某一表单项的显示或隐藏。

技术分享图片

<template>
  <el-form-renderer ref="form" :content="content" />
</template>

<script>
export default {
  name: 'hidden',
  data() {
    return {
      content: [
        {
          type: 'select',
          id: 'selected',
          label: '选择项目',
          options: [
            {
              label: '项目A',
              value: 'optionA'
            },
            {
              label: '项目B',
              value: 'optionB'
            }
          ]
        },
        {
          label: '资料',
          type: 'input',
          id: 'data',
          el: {
            placeholder: '项目B的具体内容'
          },
          hidden: form => form.selected !== 'optionB' // 如果选择项并非 项目B 则隐藏
        },
      ]
    }
  }
}
</script>

表单数据联动(on)

可以通过 on?来监听 blur?, focus?等事件来实现表单联动。

举个例子,填写 fullName?后,自动填充 lastName?

技术分享图片

<template>
  <el-form-renderer ref="form" :content="content" />
</template>

<script>
export default {
  data() {
    return {
      content: [
        {
          label: '英文名',
          type: 'input',
          id: 'fullName',
          on: {
            blur: ([event], updateForm) => {
              const value = event.target.value
              const lastName = value.split(' ')[1] // 通过空格分割出内容
              updateForm({ lastName })                       // 更新其他表单项
            },
          },
        },
        {
          label: '姓氏',
          type: 'input',
          id: 'lastName',
        }
      ]
    }
  }
}
</script>

输入/输出格式化(inputFormat/outputFormat)

拿 日期范围选择器?为例,组件输出的值是一条字符串,但后端接口格式是两个字段 {startDate, endDate},则此时需要对数据进行格式化处理。

inputFormat

转换输入的数据, 使其变成表单项需要的数据格式

<template>
  <el-form-renderer :content="content" ref="form" />
</template>

<script>
export default {
  data() {
    return {
      content: [
        {
          el: {
            type: 'daterange',
            placeholder: '选择日期',
            valueFormat: 'yyyy-MM-dd'
          },
          type: 'date-picker',
          id: 'date',
          label: '日期',
          // 接口设计的时间范围是两个字段 '2019-07-23','2019-07-24'
          // 处理后的值为 [ '2019-07-23', '2019-07-24' ]
          inputFormat: row => ([row.startDate, row.endDate])
        }
      ]
    }
  }
}
</script>

outputFormat

转换输出的数据, 使其变成需要的(接口期望的)数据格式
技术分享图片

<script>
export default {
  data() {
    return {
      content: [
        {
          el: {
            type: 'daterange',
            placeholder: '选择日期',
            valueFormat: 'yyyy-MM-dd'
          },
          type: 'date-picker',
          id: 'date',
          label: '日期', 
          // 处理前的值为 date: [ '2019-07-23', '2019-07-24' ]
          // 处理后的值为 {startDate: '2019-07-23', endDate: '2019-07-24'}
          outputFormat: val => {
            if (!val) {
              return {startDate: '', endDate: ''}
            }
            return {
              startDate: val[0],
              endDate: val[1]
            }
          }
        }
      ]
    }
  }
}
</script>

自定义组件(component)

@femessage/el-form-renderer?默认支持的?type?有限, 只能渲染常见的表单项。对于个性化的需求,?比如想渲染一个上传组件,type?就不够用了, 那怎么办呢? 这时候 component? 选项就派上用场了。

component可以渲染自定义组件,而编写自定义组件的关键是在组件内部实现 v-model:

  • 有一个 props 为 value
  • 对外触发 input 事件

技术分享图片

<!-- 自定义组件 my-input -->
<template>
  <div class="my-component">
    <el-input :value="value" @input="onInput" />
    <el-button @click="onInput('我帮你输入点东西')">帮我输入点东西</el-button>
  </div>
</template>

<script>
export default {
  props: {
    value: String
  },
  methods: {
    onInput(val) {
      this.$emit('input', val)
    }
  }
}
</script>

则可以用 component? 属性让?@femessage/el-form-renderer?渲染此自定义组件

<template>
  <div class="my-component">
    <el-input :value="value" @input="onInput" />
    <el-button @click="onInput('我帮你输入点东西')">帮我输入点东西</el-button>
  </div>
</template>

<script>
export default {
  props: {
    value: String
  },
  methods: {
    onInput(val) {
      this.$emit('input', val)
    }
  }
}
</script>

目前团队对常见的表单扩展组件都根据标准实现了 v-model, 因此都可以不写 template, 由?@femessage/el-form-renderer?实现数据驱动渲染

复杂的表单验证(rules)

一个复杂的表单项配置, 往往需要定义一些规则(rules)来限制用户输入, 规则里面可能还会有自定义的验证器(validator), 这样的表单项多了之后, 就会导致页面文件的配置项变得很长很长。

解决方案是在组件内部设置校验规则, 从而达到封装隐藏目的。 使用者不用关心表单的验证规则,直接引入组件并使用就好。

下面展示一个结合自定义组件(基本输入框)封装的验证规则,?其规则如下:

  • 不允许空值
  • 只能输入3位数或以上
  • 必须以123开头

技术分享图片

<template>
  <el-input :value="value" @input="onInput"/>
</template>
<script>
export default {
  rules() {
    return [
      {
        required: true,
        validator: (rule, val, callback) => {
          if (!val) {
            callback(new Error('不能为空!'))
          } else if (!val.length >= 3) {
            callback(new Error('只能输入3位数或以上!'))
          } else if (!/^123/.test(val)) {
            callback(new Error('必须是以123开头!'))
          } else {
            callback()
          }
        }
      }
    ]
  },
  props: ['value'],
  methods: {
    onInput(val) {
      this.$emit('input', val)
    }
  }
}
</script>

结语

我们内部项目都在使用?@femessage/el-form-renderer,可以在 github?上找到更多信息。

欢迎大家使用,提高项目开发效率~

💡我们的表单解决方案 el-form-renderer

原文:https://www.cnblogs.com/levy9527/p/11251311.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!