Form

Form

引用

import { Form, regist } from "litos-ui";

regist(Form);

演示

基础用法

基本的表单数据域控制展示，包含布局、初始化、验证、提交。数据验证采用 ph-utils/validator

1. 如果想要实现按钮之间的间隔，需要引入 litos-ui/styles/reset.css 文件
2. 当 Button 在 Form 里面时，如果 Button 的 html-type 属性为 reset、submit 时会自动触发表单的重置、提交。

InnerBlock

设置 inner-block 能够让表单的行内元素铺满剩余宽度

行内表单

当前表单较简单时，可以在一行内放置表单。

通过设置 inline 属性为 true 可以让表单域变为行内的表单域。

对齐方式

通过设置 label-position 来应用标签和内容的对齐方式。

您可以分别设置 l-form-item 的 label-position. 如果值为空, 则会使用 l-form 的 label-position。

只使用 FormItem

FormItem 可以不放在 Form 里面，从而进行单独使用。

API

Form Attibutes

参数	说明	类型	默认值
inline	行内表单, 每一行放置尽量多的项	boolean	false
label-position	标签的位置	left、right、top	right
label-width	表单域标签的宽度	string	auto
disabled	是否禁用	boolean	false
inner-block	表单内的输入元素是否铺满剩余宽度	boolean	false
novalidate	是否在提交时禁用表单验证	boolean	false

Form Slots

名称	说明
default	表单项

Form Events

事件名	说明	回调参数
submit	表单提交事件	(e: Event): void

Form Methods

方法名	说明	类型
validate	对整个表单进行校验的方法	() => void
validateField	对部分表单字段进行校验的方法	`(props: string
clearValidate	移除表单项的校验结果	() => void

FormItem Attributes

参数	说明	类型	默认值
label	标签文本	string	-
verify	内置验证规则:required-必填,same:password-一般用于验证确认密码,phone-验证电话号码	string	-
pattern	正则表达式	string	-
validity	验证失败时的提示信息	string	-
name	表单域 name 字段	string	-
label-position	标签的位置	left、right、top	right
required	是否必填	boolean	false
disabled	是否禁用	boolean	false
inner-block	表单内的输入元素是否铺满剩余宽度	boolean	false

FormItem Slots

名称	说明
default	表单项

FormItem Events

事件名	说明	回调参数
blur	在 Input 失去焦点时触发	(e: Event): void
focus	在 Input 获得焦点时触发	`(e: Event

Form CSS Variables

变量名	说明	默认值
-	-	-