Skip to content

proCardList 卡片列表

重磅封装的卡片列表,集成 CRUD 基础功能,内部集成了 ElCard + DialogForm

属性

ts
interface Props {
  crud: ICRUD
  pageSize?: number
  formConfig: BasicForm
  dialogConfig?: DialogProps
  height?: string
  cardHeight?: string
  showAdd?: boolean
  span?: number
  paginationConfig?: PaginationProps
}
参数说明类型默认值可选值
crud(必传)增删改查ICRUD-
pageSize分页大小Number12
formConfig(必传)表单配置BasicForm
dialogConfig弹窗配置,参考 element-plus dialog 配置Object
height卡片列表高度String
cardHeight卡片项高度String
showAdd是否显示新增Booleantrue
span栅格占据的列数Number4
paginationConfig分页配置PaginationProps
queryConfig查询配置Query{maxShow: 3,col: {xs: 24,sm: 12,md: 8,lg: 6},fold: true,fluid:true}

ICRUD

ts
interface ICRUD {
  create: (data: { [key: string]: any }) => Promise<any> // 创建
  update: (data: { [key: string]: any }) => Promise<any> // 更新
  delete: ({ id }: { id: string }) => Promise<any> // 删除
  deleteBatch?: ({ ids }: { ids: string }) => Promise<any> // 批量删除
  getList: (data: { pageSize: number; pageNo: number; [key: string]: any }) // 获取列表
  getRecord?: ({ id }: { id: string }) => Promise<any> // 获取单个记录
}
ts
type Form = {
  props?: Partial<FormProps> // 表单属性
  route?: any // 路由(默认是弹窗方式,如果要打开一个新页面,可以配置此项)
  span?: number // 栅格占位
  disabled?: boolean // 是否禁用
}

BasicForm

ts
type BasicForm = Form & {
  formItems: BasicFormItem[]
}
type BasicFormItem = {
  label: string // 表单标签
  value: any // 表单值
  name: string // 接口需要的字段名
  type: string // 表单类型
  placeholder?: string
  children?: Array<BasicFormItem>
  options?: Array<any> // 下拉框选项
  search?: boolean // 是否出现在搜索框
  required?: boolean // 是否必填
  rules?: FormItemRule | FormItemRule[] // 表单验证规则
  span?: number // 栅格占位
  props?: object // 组件属性
  events?: object // 组件事件
  request?: Function // 异步请求数据
  slots?: Array<FormSlot> // 自定义插槽
  notFormItem?: boolean // 是否为表单项
  hidden?: boolean // 是否隐藏
  extra?: any // 额外信息
  formItemProps?: object // formItem属性
  formItemSlots?: Array<FormSlot> // formItem插槽
}

Query

ts
interface Query {
  maxShow?: number // 最多显示查询条件数量
  col?: ColProps // 列配置
  fold: boolean // 是否开启展开收起功能
  searchText?: string // 查询按钮文字
  fluid?: boolean // 是否开启栅格布局
}

方法

方法名说明类型参数
handleCreate表单(from)新增Function
handleUpdate表单(from)编辑Functionrow
handleDelete表格(table)删除Functionid:string、number
refresh表格(table)刷新Function

事件

事件名说明类型参数
click-create点击新增按钮触发Function
click-edit点击新增编辑触发Functionrow

插槽

插槽名说明
query自定义查询内容
header自定义头部内容
-自定义默认内容