Skip to content

约定

数据驱动视图的设计理念,通过简单配置数据项实现需求。

版本

目前支持的element-plus版本为2.7.6版本,会持续兼容。

使用约定

字段命名

表单和表格组件中,column项的配置是类似的。

  • component:配置展示组件
  • fieldProps:配置组件属性
  • formItemProps:装饰组件属性
  • field:组件字段名
  • label:标题
  • on + 事件:组件的事件配置
  • slot:插槽
  • renderh函数render函数
  • hide:显隐展示配置(基于v-if
  • show: 显隐展示配置(基于v-show

内置组件

表单或表格的column项,component字段支持局部组件(受控组件)全局组件(受控组件)和内置组件。

内置组件包含:inputselectradiocheckbox,在表单和表格组件内部会被处理为z-inputz-select等。

使用示例:

js
import { ElInput } from 'element-plus'

const columns = [
  {
    component: ElInput
  },
  {
    component: 'el-input'
  },
  {
    component: 'input'
  },
]

插槽

组件或column项,若支持labeltitle等字段,您可以传入例如labelSlottitleSlot等带有Slot的字符串,组件内部会处理为插槽。

支持自定义的属性或配置,均支持h函数插槽render函数

默认配置

ZFormZFilterFormZCrud等组件会默认配置placeholderclearablefilterable等属性,支持自定义。

ZFilterForm表单响应式默认配置为{ xl: 6, lg: 8, md: 8, sm: 12, xs: 24 }

Released under the MIT License.