仿iview实现自定义form组件

思路:拆分为三个组件:FormFormItemInput(后续可进行扩展)

  • Form:表单功能,配置校验规则,并可触发子组件的校验和重置(后续可继续封装)
  • FormItem:展示label,且根据属性props判断是否需校验
  • Input:原生input,当兼听到input时,上报,实现双向绑定并触发校验
  • 表单的使用
// login组件
<template>
    <ele-form class="login-form" ref="formValidate" :model="formValidate" :rules="ruleValidate" :label-width="80">
        <ele-form-item label="用户名" prop="username">
            <ele-input :value="formValidate.username" @input="input($event, 'username')" placeholder="请输入用户名"></ele-input>
        </ele-form-item>
        <ele-form-item label="密码" prop="password">
            <ele-input :value="formValidate.password" @input="input($event, 'password')" type="password" placeholder="请输入密码"></ele-input>
        </ele-form-item>
        <ele-form-item>
            <button type="primary" @click="handleSubmit('formValidate')">提交</button>
            <button @click="handleReset('formValidate')">重置</button>
        </ele-form-item>
    </ele-form>
</template>

<script>
import eleForm from "@/components/form/ele-form/ele-form"
import eleFormItem from '@/components/form/ele-form-item/ele-form-item'
import eleInput from '@/components/form/ele-input/ele-input'

export default {
    components: {
        eleForm,
        eleFormItem,
        eleInput
    },
    data() {
        return {
            formValidate: {
                username: '',
                password: ''
            },
            ruleValidate: {
                username: [{ required: true, message: '请输入用户名', trigger: 'change' }],
                password: [{ required: true, message: '请输入密码', trigger: 'change' }]
            }
        }
    },
    mounted() {

    },
    methods: {
        input(value, type) {
            this.formValidate[type] = value
        },
        handleSubmit(name) {
            this.$refs[name].validate(valid => {
                console.log(valid)
            });
        },
        handleReset(name) {
            this.$refs[name].resetFields();
        }
    }
}
</script>
  • form组件:
    • form-item预留槽位
    • 将数据传递给后代便于它们访问数据模型和校验规则
// ele-form
<template>
    <div>
        <slot></slot>
    </div>
</template>

<script>
export default {
    // 一个对象,或者是一个返回对象的函数。里面包含要给子孙后代的东西,也就是属性和属性值
    provide() {
        return { 
            // 表单实例
            form: this
        }
    },
    props: {
        // 表单数据对象
        model: {
            type: Object, required: true, default: () => {}
        },
        // 表单验证规则
        rules: {
            type: Object, default: () => {}
        },
        // 表单域标签的宽度,所有的 FormItem 都会继承 Form 组件的 label-width 的值
        'label-width': {
            type: Number, default: 100
        }
    },
    data() {
        return {

        }
    },
    methods: {
        async validate(callback) {
            const tasks = this.$children.filter(item => item.prop).map(item => item.validate())
            const results = await Promise.all(tasks)
            if (results.some(valid => !valid)) {
                // 校验失败
                callback(false)
            } else {
                // 校验成功
                callback(true)
            }
        },
        resetFields() {
            const tasks = this.$children.filter(item => item.prop)
            tasks.forEach(item => {
                item.errorMessage = ''
                item.form.model[item.prop] = ''
            })
        }
    },
}
</script>
  • formItem组件:
    • 任务1:给Input预留插槽 - slot
    • 任务2:展示label和校验信息
    • 任务3:进行校验
// ele-form-item
<template>
    <div :class="{'form-item': true, 'form-item-error': errorMessage}">
        <label :class="{'has-label': label}">{{label}}</label>
        <div class="form-content">
            <div class="row">
                <slot></slot>
            </div>
            <div v-if="errorMessage" class="error">{{errorMessage}}</div>
        </div>
    </div>
</template>

<script>
import Validator from 'async-validator'
import { Promise } from 'q'

export default {
    // 一个字符串数组,或者是一个对象
    inject: [ 'form' ],
    props: {
        label: {
            type: String,
            default: ''
        },
        prop: {
            type: String,
            default: ''
        }
    },
    data() {
        return {
            errorMessage: ''
        }
    },
    created() {
        this.$on('validate', this.validate)
    },
    methods: {
        validate() {
            return new Promise(resolve => {
                // 制定校验规则
                const descriptor = { [this.prop]: this.form.rules[this.prop] }
                // 创建校验器
                const validator = new Validator(descriptor)
                // 执行校验
                validator.validate(
                    descriptor,
                    errors => {
                        console.log(errors, this.form.model[this.prop])
                        if (errors && errors.length) {
                            this.errorMessage = errors[0].message
                            resolve(false)
                        } else {
                            this.errorMessage = ''
                            resolve(true)
                        }
                    }
                )
            })
        }
    },
}
</script>
  • input组件:
    • 任务1:实现自定义组件双向绑定功能,v-model是语法糖,实现自定义组件双绑需要指定:value和@input
    • 任务2:值发生变化时通知Form组件实现双向绑定,并且通知FormItem组件触发校验
<template>
    <input class="ipt" :type="type" :value="value" @input="onInput">
</template>

<script>
    export default {
        props: {
            type: {
                type: String,
                default: 'text'
            },
            value: {
                type: String,
                default: ''
            }
        },
        data() {
            return {

            }
        },
        methods: {
            // 当数据发生变化时
            onInput(event) {
                // 通知父组件,实现双向绑定
                this.$emit('input', event.target.value)
                // 通知 FormItem 执行校验
                this.$parent.$emit('validate')
            }
        }
    }
</script>

遗留问题:async-validator会报错XXX is not a string

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,826评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,968评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,234评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,562评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,611评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,482评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,271评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,166评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,608评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,814评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,926评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,644评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,249评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,866评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,991评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,063评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,871评论 2 354

推荐阅读更多精彩内容