Form 表单
表单包含 输入框
, 单选框
, 下拉选择
, 多选框
等用户输入的组件。 使用表单,您可以收集、验证和提交数据。
典型表单
最基础的表单包括各种输入表单项,比如input、select、radio、checkbox等。
在每一个 form 组件中,你需要一个 form-item 字段作为输入项的容器,用于获取值与验证值。
form value:
{ "email": "123", "password": "", "confirmPwd": "" }
<template>
<div>
<Form :model="model" :rules="rules" ref="formRef">
<FormItem label="the email" prop="email">
<Input v-model="model.email" />
</FormItem>
<FormItem label="the password" prop="password">
<Input type="password" v-model="model.password" />
</FormItem>
<FormItem prop="confirmPwd" label="confirm password">
<Input v-model="model.confirmPwd" type="password" />
</FormItem>
<div :style="{ textAlign: 'center' }">
<Button type="primary" @click.prevent="submit">Submit</Button>
<Button @click.prevent="reset">Reset</Button>
</div>
</Form>
<div>
form value:
<pre>{{ model }}</pre>
</div>
</div>
</template>
<script setup>
import { reactive, ref } from 'vue'
// This starter template is using Vue 3 <script setup> SFCs
// Check out https://vuejs.org/api/sfc-script-setup.html#script-setup
import Form from '@/components/Form/Form.vue'
import FormItem from '@/components/Form/FormItem.vue'
import Input from '@/components/Input/Input.vue'
import Button from '@/components/Button/Button.vue'
const formRef = ref()
const model = reactive({
email: '123',
password: '',
confirmPwd: '',
})
const rules = {
email: [{ type: 'email', required: true, trigger: 'blur', message: '邮件格式不对' }],
password: [
{ type: 'string', required: true, trigger: 'blur', min: 3, max: 5, message: '密码不安全' },
],
confirmPwd: [
{ type: 'string', required: true, trigger: 'blur', message: '未填' },
{
validator: (rule, value) => value === model.password,
trigger: 'blur',
message: '两个密码必须相同',
},
],
}
const submit = async () => {
try {
const result = await formRef.value.validate()
console.log('validateFrom: ', result)
// console.log('passed!')
} catch (e) {
console.log('the error', e)
}
}
const reset = () => {
formRef.value.resetFields()
}
</script>
Props
键名 | 描述 | 类型 | 默认值 |
---|---|---|---|
message | 消息内容 | string / VNode | - |
duration | message 持续时间 | number | 4000 (毫秒) |
showClose | 是否有 close Icon 可手动关闭 | boolean | false |
type | 默认提供四种类型支持 | success、info、warning、danger | info |
transitionName | 过渡效果 | string | fade |
onDestory | 组件销毁方法 | Function | - |