Skip to content

FormItem

全新的 FormItem 组件,相比于 Element 的 FormItem,它支持的功能更多,同时它的定位是纯样式组件,不管理表单状态,所以也会更轻量,更方便定制

该组件经过重构,请注意更新后的文档。移除了全部 Antd 内置的而 Element-Plus 没有开发的功能。本组件库主要是 Element-Plus 的 Formily 封装, 不应考虑将设计风格与 Antd 对齐。但是在布局配置项上保留了原本Formily的配置方式。

  1. 移除了inset配置项
  2. 移除了bordered配置项
  3. 移除了天然会被Vue继承的属性,如classstyle
  4. 移除了其他Antd中实现的,并非Formily实现的功能

注意

由于该组件的样式与交互基本沿用了 Element-Plus 的 FormItem,因此移除了原来浅层封装的ElFormItem组件。

注意

由于现在formily的decorator的使用不支持插槽,form-item组件中原有通过插槽支持的功能现在只能通过传入VNode实现。

常用属性案例

尺寸控制案例

API

FormItem Attributes

属性名类型描述默认值
labelstring | VNode标签-
forstring关联的表单字段-
tooltipstring | VNode问号提示-
addonBeforestring | VNode前缀内容-
addonAfterstring | VNode后缀内容-
extrastring | VNode扩展描述文案-
feedbackTextstring反馈文案-
feedbackStatusenum反馈状态-
asteriskboolean星号提醒-
colonboolean是否显示冒号true
labelAlignenum标签文本对齐方式-
wrapperAlignenum内容文本对齐方式-
labelWrapboolean标签换行,超出部分显示省略号,hover 显示 tooltipfalse
labelWidthnumber标签固定宽度-
wrapperWidthnumber内容固定宽度-
wrapperWrapboolean内容换行,超出部分显示省略号,hover 显示 tooltipfalse
labelColnumber标签网格所占列数,和内容列数加起来总和为 24-
wrapperColnumber内容网格所占列数,和标签列数加起来总和为 24-
fullnessboolean内容是否撑满false
sizeenum尺寸default
layoutenum布局模式-
feedbackLayoutenum反馈布局'loose'
tooltipLayoutenum提示布局-

FormItem.BaseItem

纯样式组件,属性与 FormItem 一样,与 Formily Core 不做状态桥接,主要用于一些需要依赖 FormItem 的样式布局能力,但不希望接入 Field 状态的场景