• ElementUI浅尝辄止33：Form 表单

    Form 表单：日常业务中很常见，由输入框、选择器、单选框、多选框等控件组成，用以收集、校验、提交数据，常见于表单请求、登录，数据校验等业务操作中

    1.如何使用？

    包括各种表单项，比如输入框、选择器、开关、单选框、多选框等。

    1. /*在 Form 组件中，每一个表单域由一个 Form-Item 组件构成，表单域中可以放置各种类型的表单控件，包括 Input、Select、Checkbox、Radio、Switch、DatePicker、TimePicker*/
    2.  
    3. "form" :model="form" label-width="80px">
    4.   <el-form-item label="活动名称">
    5.     <el-input v-model="form.name">el-input>
    6.   el-form-item>
    7.   <el-form-item label="活动区域">
    8.     <el-select v-model="form.region" placeholder="请选择活动区域">
    9.       <el-option label="区域一" value="shanghai">el-option>
    10.       <el-option label="区域二" value="beijing">el-option>
    11.     el-select>
    12.   el-form-item>
    13.   <el-form-item label="活动时间">
    14.     <el-col :span="11">
    15.       <el-date-picker type="date" placeholder="选择日期" v-model="form.date1" style="width: 100%;">el-date-picker>
    16.     el-col>
    17.     <el-col class="line" :span="2">-el-col>
    18.     <el-col :span="11">
    19.       <el-time-picker placeholder="选择时间" v-model="form.date2" style="width: 100%;">el-time-picker>
    20.     el-col>
    21.   el-form-item>
    22.   <el-form-item label="即时配送">
    23.     <el-switch v-model="form.delivery">el-switch>
    24.   el-form-item>
    25.   <el-form-item label="活动性质">
    26.     <el-checkbox-group v-model="form.type">
    27.       <el-checkbox label="美食/餐厅线上活动" name="type">el-checkbox>
    28.       <el-checkbox label="地推活动" name="type">el-checkbox>
    29.       <el-checkbox label="线下主题活动" name="type">el-checkbox>
    30.       <el-checkbox label="单纯品牌曝光" name="type">el-checkbox>
    31.     el-checkbox-group>
    32.   el-form-item>
    33.   <el-form-item label="特殊资源">
    34.     <el-radio-group v-model="form.resource">
    35.       <el-radio label="线上品牌商赞助">el-radio>
    36.       <el-radio label="线下场地免费">el-radio>
    37.     el-radio-group>
    38.   el-form-item>
    39.   <el-form-item label="活动形式">
    40.     <el-input type="textarea" v-model="form.desc">el-input>
    41.   el-form-item>
    42.   <el-form-item>
    43.     <el-button type="primary" @click="onSubmit">立即创建el-button>
    44.     <el-button>取消el-button>
    45.   el-form-item>
    47. <script>
    48.   export default {
    49.     data() {
    50.       return {
    51.         form: {
    52.           name: '',
    53.           region: '',
    54.           date1: '',
    55.           date2: '',
    56.           delivery: false,
    57.           type: [],
    58.           resource: '',
    59.           desc: ''
    60.         }
    61.       }
    62.     },
    63.     methods: {
    64.       onSubmit() {
    65.         console.log('submit!');
    66.       }
    67.     }
    68.   }
    69. script>

    W3C 标准中有如下规定：

    When there is only one single-line text input field in a form, the user agent should accept Enter in that field as a request to submit the form.

    即：当一个 form 元素中只有一个输入框时，在该输入框中按下回车应提交该表单。如果希望阻止这一默认行为，可以在  标签上添加 @submit.native.prevent。

    2.行内表单

    当垂直方向空间受限且表单较简单时，可以在一行内放置表单。

    1. 设置 inline 属性可以让表单域变为行内的表单域
    2.  
    3. "true" :model="formInline" class="demo-form-inline">
    4.   <el-form-item label="审批人">
    5.     <el-input v-model="formInline.user" placeholder="审批人">el-input>
    6.   el-form-item>
    7.   <el-form-item label="活动区域">
    8.     <el-select v-model="formInline.region" placeholder="活动区域">
    9.       <el-option label="区域一" value="shanghai">el-option>
    10.       <el-option label="区域二" value="beijing">el-option>
    11.     el-select>
    12.   el-form-item>
    13.   <el-form-item>
    14.     <el-button type="primary" @click="onSubmit">查询el-button>
    15.   el-form-item>
    17. <script>
    18.   export default {
    19.     data() {
    20.       return {
    21.         formInline: {
    22.           user: '',
    23.           region: ''
    24.         }
    25.       }
    26.     },
    27.     methods: {
    28.       onSubmit() {
    29.         console.log('submit!');
    30.       }
    31.     }
    32.   }
    33. script>

    3.对齐方式

    根据具体目标和制约因素，选择最佳的标签对齐方式。

    1. //通过设置 label-position 属性可以改变表单域标签的位置，可选值为 top、left，当设为 top 时标签会置于表单域的顶部
    2.  
    3. "labelPosition" size="small">
    4.   <el-radio-button label="left">左对齐el-radio-button>
    5.   <el-radio-button label="right">右对齐el-radio-button>
    6.   <el-radio-button label="top">顶部对齐el-radio-button>
    8. <div style="margin: 20px;">div>
    9. <el-form :label-position="labelPosition" label-width="80px" :model="formLabelAlign">
    10.   <el-form-item label="名称">
    11.     <el-input v-model="formLabelAlign.name">el-input>
    12.   el-form-item>
    13.   <el-form-item label="活动区域">
    14.     <el-input v-model="formLabelAlign.region">el-input>
    15.   el-form-item>
    16.   <el-form-item label="活动形式">
    17.     <el-input v-model="formLabelAlign.type">el-input>
    18.   el-form-item>
    19. el-form>
    20. <script>
    21.   export default {
    22.     data() {
    23.       return {
    24.         labelPosition: 'right',
    25.         formLabelAlign: {
    26.           name: '',
    27.           region: '',
    28.           type: ''
    29.         }
    30.       };
    31.     }
    32.   }
    33. script>

    4.表单验证

    在防止用户犯错的前提下，尽可能让用户更早地发现并纠正错误

    1. //Form 组件提供了表单验证的功能，只需要通过 rules 属性传入约定的验证规则，并将 Form-Item 的 prop 属性设置为需校验的字段名即可。
    2.  
    3. "ruleForm" :rules="rules" ref="ruleForm" label-width="100px" class="demo-ruleForm">
    4.   <el-form-item label="活动名称" prop="name">
    5.     <el-input v-model="ruleForm.name">el-input>
    6.   el-form-item>
    7.   <el-form-item label="活动区域" prop="region">
    8.     <el-select v-model="ruleForm.region" placeholder="请选择活动区域">
    9.       <el-option label="区域一" value="shanghai">el-option>
    10.       <el-option label="区域二" value="beijing">el-option>
    11.     el-select>
    12.   el-form-item>
    13.   <el-form-item label="活动时间" required>
    14.     <el-col :span="11">
    15.       <el-form-item prop="date1">
    16.         <el-date-picker type="date" placeholder="选择日期" v-model="ruleForm.date1" style="width: 100%;">el-date-picker>
    17.       el-form-item>
    18.     el-col>
    19.     <el-col class="line" :span="2">-el-col>
    20.     <el-col :span="11">
    21.       <el-form-item prop="date2">
    22.         <el-time-picker placeholder="选择时间" v-model="ruleForm.date2" style="width: 100%;">el-time-picker>
    23.       el-form-item>
    24.     el-col>
    25.   el-form-item>
    26.   <el-form-item label="即时配送" prop="delivery">
    27.     <el-switch v-model="ruleForm.delivery">el-switch>
    28.   el-form-item>
    29.   <el-form-item label="活动性质" prop="type">
    30.     <el-checkbox-group v-model="ruleForm.type">
    31.       <el-checkbox label="美食/餐厅线上活动" name="type">el-checkbox>
    32.       <el-checkbox label="地推活动" name="type">el-checkbox>
    33.       <el-checkbox label="线下主题活动" name="type">el-checkbox>
    34.       <el-checkbox label="单纯品牌曝光" name="type">el-checkbox>
    35.     el-checkbox-group>
    36.   el-form-item>
    37.   <el-form-item label="特殊资源" prop="resource">
    38.     <el-radio-group v-model="ruleForm.resource">
    39.       <el-radio label="线上品牌商赞助">el-radio>
    40.       <el-radio label="线下场地免费">el-radio>
    41.     el-radio-group>
    42.   el-form-item>
    43.   <el-form-item label="活动形式" prop="desc">
    44.     <el-input type="textarea" v-model="ruleForm.desc">el-input>
    45.   el-form-item>
    46.   <el-form-item>
    47.     <el-button type="primary" @click="submitForm('ruleForm')">立即创建el-button>
    48.     <el-button @click="resetForm('ruleForm')">重置el-button>
    49.   el-form-item>
    51. <script>
    52.   export default {
    53.     data() {
    54.       return {
    55.         ruleForm: {
    56.           name: '',
    57.           region: '',
    58.           date1: '',
    59.           date2: '',
    60.           delivery: false,
    61.           type: [],
    62.           resource: '',
    63.           desc: ''
    64.         },
    65.         rules: {
    66.           name: [
    67.             { required: true, message: '请输入活动名称', trigger: 'blur' },
    68.             { min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
    69.           ],
    70.           region: [
    71.             { required: true, message: '请选择活动区域', trigger: 'change' }
    72.           ],
    73.           date1: [
    74.             { type: 'date', required: true, message: '请选择日期', trigger: 'change' }
    75.           ],
    76.           date2: [
    77.             { type: 'date', required: true, message: '请选择时间', trigger: 'change' }
    78.           ],
    79.           type: [
    80.             { type: 'array', required: true, message: '请至少选择一个活动性质', trigger: 'change' }
    81.           ],
    82.           resource: [
    83.             { required: true, message: '请选择活动资源', trigger: 'change' }
    84.           ],
    85.           desc: [
    86.             { required: true, message: '请填写活动形式', trigger: 'blur' }
    87.           ]
    88.         }
    89.       };
    90.     },
    91.     methods: {
    92.       submitForm(formName) {
    93.         this.$refs[formName].validate((valid) => {
    94.           if (valid) {
    95.             alert('submit!');
    96.           } else {
    97.             console.log('error submit!!');
    98.             return false;
    99.           }
    100.         });
    101.       },
    102.       resetForm(formName) {
    103.         this.$refs[formName].resetFields();
    104.       }
    105.     }
    106.   }
    107. script>

    5.自定义校验规则

    这个例子中展示了如何使用自定义验证规则来完成密码的二次验证。

    1. 本例还使用status-icon属性为输入框添加了表示校验结果的反馈图标。
    2.  
    3. "ruleForm" status-icon :rules="rules" ref="ruleForm" label-width="100px" class="demo-ruleForm">
    4.   <el-form-item label="密码" prop="pass">
    5.     <el-input type="password" v-model="ruleForm.pass" autocomplete="off">el-input>
    6.   el-form-item>
    7.   <el-form-item label="确认密码" prop="checkPass">
    8.     <el-input type="password" v-model="ruleForm.checkPass" autocomplete="off">el-input>
    9.   el-form-item>
    10.   <el-form-item label="年龄" prop="age">
    11.     <el-input v-model.number="ruleForm.age">el-input>
    12.   el-form-item>
    13.   <el-form-item>
    14.     <el-button type="primary" @click="submitForm('ruleForm')">提交el-button>
    15.     <el-button @click="resetForm('ruleForm')">重置el-button>
    16.   el-form-item>
    18. <script>
    19.   export default {
    20.     data() {
    21.       var checkAge = (rule, value, callback) => {
    22.         if (!value) {
    23.           return callback(new Error('年龄不能为空'));
    24.         }
    25.         setTimeout(() => {
    26.           if (!Number.isInteger(value)) {
    27.             callback(new Error('请输入数字值'));
    28.           } else {
    29.             if (value < 18) {
    30.               callback(new Error('必须年满18岁'));
    31.             } else {
    32.               callback();
    33.             }
    34.           }
    35.         }, 1000);
    36.       };
    37.       var validatePass = (rule, value, callback) => {
    38.         if (value === '') {
    39.           callback(new Error('请输入密码'));
    40.         } else {
    41.           if (this.ruleForm.checkPass !== '') {
    42.             this.$refs.ruleForm.validateField('checkPass');
    43.           }
    44.           callback();
    45.         }
    46.       };
    47.       var validatePass2 = (rule, value, callback) => {
    48.         if (value === '') {
    49.           callback(new Error('请再次输入密码'));
    50.         } else if (value !== this.ruleForm.pass) {
    51.           callback(new Error('两次输入密码不一致!'));
    52.         } else {
    53.           callback();
    54.         }
    55.       };
    56.       return {
    57.         ruleForm: {
    58.           pass: '',
    59.           checkPass: '',
    60.           age: ''
    61.         },
    62.         rules: {
    63.           pass: [
    64.             { validator: validatePass, trigger: 'blur' }
    65.           ],
    66.           checkPass: [
    67.             { validator: validatePass2, trigger: 'blur' }
    68.           ],
    69.           age: [
    70.             { validator: checkAge, trigger: 'blur' }
    71.           ]
    72.         }
    73.       };
    74.     },
    75.     methods: {
    76.       submitForm(formName) {
    77.         this.$refs[formName].validate((valid) => {
    78.           if (valid) {
    79.             alert('submit!');
    80.           } else {
    81.             console.log('error submit!!');
    82.             return false;
    83.           }
    84.         });
    85.       },
    86.       resetForm(formName) {
    87.         this.$refs[formName].resetFields();
    88.       }
    89.     }
    90.   }
    91. script>

    6. 动态增减表单项

    1. //除了在 Form 组件上一次性传递所有的验证规则外还可以在单个的表单域上传递属性的验证规则
    2.  
    3. "dynamicValidateForm" ref="dynamicValidateForm" label-width="100px" class="demo-dynamic">
    4.   <el-form-item
    5.     prop="email"
    6.     label="邮箱"
    7.     :rules="[
    8.       { required: true, message: '请输入邮箱地址', trigger: 'blur' },
    9.       { type: 'email', message: '请输入正确的邮箱地址', trigger: ['blur', 'change'] }
    10.     ]"
    11.   >
    12.     <el-input v-model="dynamicValidateForm.email">el-input>
    13.   el-form-item>
    14.   <el-form-item
    15.     v-for="(domain, index) in dynamicValidateForm.domains"
    16.     :label="'域名' + index"
    17.     :key="domain.key"
    18.     :prop="'domains.' + index + '.value'"
    19.     :rules="{
    20.       required: true, message: '域名不能为空', trigger: 'blur'
    21.     }"
    22.   >
    23.     <el-input v-model="domain.value">el-input><el-button @click.prevent="removeDomain(domain)">删除el-button>
    24.   el-form-item>
    25.   <el-form-item>
    26.     <el-button type="primary" @click="submitForm('dynamicValidateForm')">提交el-button>
    27.     <el-button @click="addDomain">新增域名el-button>
    28.     <el-button @click="resetForm('dynamicValidateForm')">重置el-button>
    29.   el-form-item>
    31. <script>
    32.   export default {
    33.     data() {
    34.       return {
    35.         dynamicValidateForm: {
    36.           domains: [{
    37.             value: ''
    38.           }],
    39.           email: ''
    40.         }
    41.       };
    42.     },
    43.     methods: {
    44.       submitForm(formName) {
    45.         this.$refs[formName].validate((valid) => {
    46.           if (valid) {
    47.             alert('submit!');
    48.           } else {
    49.             console.log('error submit!!');
    50.             return false;
    51.           }
    52.         });
    53.       },
    54.       resetForm(formName) {
    55.         this.$refs[formName].resetFields();
    56.       },
    57.       removeDomain(item) {
    58.         var index = this.dynamicValidateForm.domains.indexOf(item)
    59.         if (index !== -1) {
    60.           this.dynamicValidateForm.domains.splice(index, 1)
    61.         }
    62.       },
    63.       addDomain() {
    64.         this.dynamicValidateForm.domains.push({
    65.           value: '',
    66.           key: Date.now()
    67.         });
    68.       }
    69.     }
    70.   }
    71. script>

    7.数字类型验证

    数字类型的验证需要在 v-model 处加上 .number 的修饰符，这是 Vue 自身提供的用于将绑定值转化为 number 类型的修饰符。

    1. <el-form :model="numberValidateForm" ref="numberValidateForm" label-width="100px" class="demo-ruleForm">
    2.   <el-form-item
    3.     label="年龄"
    4.     prop="age"
    5.     :rules="[
    6.       { required: true, message: '年龄不能为空'},
    7.       { type: 'number', message: '年龄必须为数字值'}
    8.     ]"
    9.   >
    10.     <el-input type="age" v-model.number="numberValidateForm.age" autocomplete="off"></el-input>
    11.   </el-form-item>
    12.   <el-form-item>
    13.     <el-button type="primary" @click="submitForm('numberValidateForm')">提交</el-button>
    14.     <el-button @click="resetForm('numberValidateForm')">重置</el-button>
    15.   </el-form-item>
    16. </el-form>
    17. <script>
    18.   export default {
    19.     data() {
    20.       return {
    21.         numberValidateForm: {
    22.           age: ''
    23.         }
    24.       };
    25.     },
    26.     methods: {
    27.       submitForm(formName) {
    28.         this.$refs[formName].validate((valid) => {
    29.           if (valid) {
    30.             alert('submit!');
    31.           } else {
    32.             console.log('error submit!!');
    33.             return false;
    34.           }
    35.         });
    36.       },
    37.       resetForm(formName) {
    38.         this.$refs[formName].resetFields();
    39.       }
    40.     }
    41.   }
    42. </script>

    嵌套在 el-form-item 中的 el-form-item 标签宽度默认为零，不会继承 el-form 的 label-width。如果需要可以为其单独设置 label-width 属性。

    8.表单内组件尺寸控制

    通过设置 Form 上的 size 属性可以使该表单内所有可调节大小的组件继承该尺寸。Form-Item 也具有该属性。

    1. //如果希望某个表单项或某个表单组件的尺寸不同于 Form 上的size属性，直接为这个表单项或表单组件设置自己的size即可。
    2.  
    3. "form" :model="sizeForm" label-width="80px" size="mini">
    4.   <el-form-item label="活动名称">
    5.     <el-input v-model="sizeForm.name">el-input>
    6.   el-form-item>
    7.   <el-form-item label="活动区域">
    8.     <el-select v-model="sizeForm.region" placeholder="请选择活动区域">
    9.       <el-option label="区域一" value="shanghai">el-option>
    10.       <el-option label="区域二" value="beijing">el-option>
    11.     el-select>
    12.   el-form-item>
    13.   <el-form-item label="活动时间">
    14.     <el-col :span="11">
    15.       <el-date-picker type="date" placeholder="选择日期" v-model="sizeForm.date1" style="width: 100%;">el-date-picker>
    16.     el-col>
    17.     <el-col class="line" :span="2">-el-col>
    18.     <el-col :span="11">
    19.       <el-time-picker placeholder="选择时间" v-model="sizeForm.date2" style="width: 100%;">el-time-picker>
    20.     el-col>
    21.   el-form-item>
    22.   <el-form-item label="活动性质">
    23.     <el-checkbox-group v-model="sizeForm.type">
    24.       <el-checkbox-button label="美食/餐厅线上活动" name="type">el-checkbox-button>
    25.       <el-checkbox-button label="地推活动" name="type">el-checkbox-button>
    26.       <el-checkbox-button label="线下主题活动" name="type">el-checkbox-button>
    27.     el-checkbox-group>
    28.   el-form-item>
    29.   <el-form-item label="特殊资源">
    30.     <el-radio-group v-model="sizeForm.resource" size="medium">
    31.       <el-radio border label="线上品牌商赞助">el-radio>
    32.       <el-radio border label="线下场地免费">el-radio>
    33.     el-radio-group>
    34.   el-form-item>
    35.   <el-form-item size="large">
    36.     <el-button type="primary" @click="onSubmit">立即创建el-button>
    37.     <el-button>取消el-button>
    38.   el-form-item>
    40.  
    41. <script>
    42.   export default {
    43.     data() {
    44.       return {
    45.         sizeForm: {
    46.           name: '',
    47.           region: '',
    48.           date1: '',
    49.           date2: '',
    50.           delivery: false,
    51.           type: [],
    52.           resource: '',
    53.           desc: ''
    54.         }
    55.       };
    56.     },
    57.     methods: {
    58.       onSubmit() {
    59.         console.log('submit!');
    60.       }
    61.     }
    62.   };
    63. script>

     Form表单组件的大致内容就是这些，若想深入浅出可以前往表单组件

  • 相关阅读:
    led台灯哪个牌子质量好？2022最新的台灯牌子排名
    设计模式-观察者模式在Java中的使用示例-环境监测系统
    并发编程的12种业务场景
    [附源码]计算机毕业设计JAVA保险客户管理系统
    26-k8s的附加组件-图形化管理工具dashboard
    海豚调度器分布式部署
    南京邮电大学汇编语言程序设计实验二
    spark on yarn 的 executor、cores、driver 作用及配置
    10 个不错的 C 语言开源项目
    SingleStore数据库，离开 HTAP，人工智能是不切实际的
  • 原文地址：https://blog.csdn.net/W2457307263/article/details/132728667