Skip to content

表单子组件 xFormItem


在线预览
在线模拟尺寸:

介绍

从1.1.2开始允许非xform直接子节点了,也就是在xform可以嵌套view进行form-item布局了,但建议不要嵌套太深,影响性能. 1.1.17开始支持嵌套对象字段,key必须/分割如'user/id',sdk不支持以.分割符。

平台兼容

HarmonyH5andriodIOS小程序UTSUNIAPP-X SDKversion
☑️☑️☑️☑️4.76+1.1.18

文件路径

ts

@/uni_modules/tmx-ui/components/x-form-item/x-form-item.uvue

使用

ts

<x-form-item></x-form-item>

Props 属性

名称说明类型默认值
label表单名称
string""
showLabel是否显示标题
booleantrue
field校验的字段名称,字段名称一定要存在于form表单数据中。否则报错。
string""
required是否是必填项。设置了此值,才会执行校验。
booleanfalse
showRequired是否显示校验必填项前面的红*符号
booleantrue
rule校验规则对象
Array() : FORM_RULE[] => [] as FORM_RULE[]
labelWidth标签宽(横向表单时有效),默认空值取父form统一的设置。
string""
labelDirection默认空值取父form统一的设置。vertical\
horizontal
string""
labelFontColor默认空值取父form统一的设置。标签的文本颜色
string""
labelFontSize默认空值取父form统一的设置。标签的文本大小
string""
labelAlign标签标题对齐方式 left,right,center
string"left"
showBottomBorder是否显示底部边框
booleantrue
cellPadding排版布局上和下的间隙。[上,下]
Array() : string[] => ['10', '10'] as string[]
labelPadding排版布局上和下的间隙。[上,下],竖向时才生效
Array() : string[] => ['12', '12'] as string[]
showError校验时,是否显示下边的出错信息
booleantrue
contentStyle默认区域内的自定样式
string""

Events 事件

名称参数说明

Slots 插槽

名称说明数据
label标题-
default默认内容区域-
error出错提示的插槽-

Ref 方法

名称参数返回值说明
vaildCompele---
getVaildStatus---
clearValid---
validByblur---

示例文件路径

json

示例源码

uvue
最近更新