FormItem 表单项
必须是 c-form
的子组件,具体使用参见 c-form组件。
平台
App | 小程序 | H5 |
---|---|---|
√ | √ | √ |
属性
属性名 | 类型 | 默认值 | 说明 | 平台 |
---|---|---|---|---|
prop | String | 表单域的属性名,在使用校验规则时必填 | All | |
label | String | 输入框左边的文字提示,表单验证错误信息也会使用 | All | |
hideLabel | Boolean | false | 隐藏label | All |
labelPros | Object | null | label样式 参考c-text的props | All |
required | Boolean | false | label右边显示红色"*"号,样式显示不会对校验规则产生效果 | All |
labelPosition | String | null | label位置,left,top | All |
labelWidth | Number,String | null | label宽度 值可以是auto | All |
labelAlign | String | null | label居中方式,left/center/right | All |
labelGutter | String,Number | null | label和内容之间的间距 | All |
border | String | null | 是否显示表单域的边框 none,top,bottom | All |
borderStyle | Object | null | 边框样式 参考c-divider的props | All |
itemCntStyle | Object | null | 内容样式 | All |
errorStyle | Object | null | 错误样式 | All |
cClass | String,Array,Object | null | 组件类 | All |
cStyle | String,Array,Object | null | 组件样式 | All |
margin | String,Number,Array | null | 外边距 | All |
padding | String,Number,Array | null | 内边距 | All |
bgColor | String | null | 背景色,支持c-bg- 开头的背景色类 | All |
注意
表单项属性优先级高于c-form
组件。
插槽
插槽名 | 说明 |
---|---|
label | 标签插槽 |
labelBefore | 标签前置插槽 |
labelAfter | 标签后置插槽 |
default | 默认插槽 |
right | 默认插槽右边的插槽 |
after | 后置插槽,在下边框前,错误后 |
方法
名称 | 说明 |
---|---|
validate() | 校验当前表单项,返回一个promise对象 |
标签高度SCSS变量
scss
// 标签高度
$form-label-left-height:60rpx;
1
2
2