ProForm.d.ts 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  1. import { type FormItemRule } from 'element-plus'
  2. export = ProForm
  3. export as namespace ProForm
  4. export interface EnumProps {
  5. label?: string // 选项框显示的文字
  6. value?: string | number | boolean | any[] // 选项框值
  7. disabled?: boolean // 是否禁用此选项
  8. tagType?: string // 当 tag 为 true 时,此选择会指定 tag 显示类型
  9. children?: EnumProps[] // 为树形选择时,可以通过 children 属性指定子选项
  10. [key: string]: any
  11. }
  12. declare namespace ProForm {
  13. // element-plus 表单组件el-标签名,可以新增
  14. type ElTagName =
  15. | 'input'
  16. | 'checkbox'
  17. | 'checkbox-group'
  18. | 'select'
  19. | 'select-v2'
  20. | 'date-picker'
  21. | 'input-number'
  22. | 'select-icon'
  23. | 'tree-select'
  24. | 'cascader'
  25. | 'radio-group'
  26. | 'radio-button'
  27. | 'file-upload'
  28. | 'img-upload'
  29. | 'file-upload-s3'
  30. | 'img-upload-s3'
  31. | 'slot'
  32. | 'rate'
  33. | 'slider'
  34. | 'switch'
  35. | 'time-picker'
  36. | 'time-select'
  37. | 'transfer' // label不显示 使用插槽吧
  38. | 'icon' // 图标
  39. interface FormOptions {
  40. inline?: boolean
  41. labelWidth?: string | number
  42. labelPosition?: 'left' | 'right' | 'top'
  43. disabled?: boolean // 不可编辑
  44. hasFooter?: boolean // 是否显示底部操作按钮
  45. labelSuffix?: ': ' | string
  46. showResetButton?: boolean // 是否展示重置按钮
  47. showCancelButton?: boolean // 是否展示取消按钮
  48. submitButtonText?: string
  49. resetButtonText?: string
  50. cancelButtonText?: string
  51. blockSubmitButton?: boolean // 提交按钮是否以块级按钮呈现
  52. }
  53. interface ItemsOptions {
  54. /** form-item 配置项 */
  55. label?: string
  56. labelWidth?: string | number // 标签宽度,例如 '50px'。 可以使用 auto。
  57. prop: string // prop
  58. tooltip?: string // 问号,tooltip提示
  59. required?: boolean
  60. hideLabelSuffix?: boolean // label后缀是否隐藏
  61. rules?: FormItemRule[]
  62. span?: number // 表单col宽度
  63. show?: (params?: any) => Promise<any> | boolean | string // 是否显示 默认显示
  64. /** 表单组件配置项 */
  65. compOptions: CompAttributes // 表单组件配置项
  66. }
  67. interface FormItem {
  68. label?: string
  69. labelWidth?: string | number // 标签宽度,例如 '50px'。 可以使用 auto。
  70. prop: string // prop
  71. value?: any // 默认值
  72. tooltip?: string // 问号,tooltip提示
  73. required?: boolean
  74. rules?: FormItemRule[]
  75. span?: number // 表单col宽度
  76. show?: (params?: any) => Promise<any> | boolean | string // 是否显示 默认显示
  77. // showLabel?: boolean // 是否显示label
  78. // showHelp?: boolean // 是否显示帮助信息
  79. // helpMessage?: string | string[]
  80. // render?: (form: any) => JSX.Element
  81. // renderFormItem?: (form: any) => JSX.Element
  82. // renderComponent?: (form: any) => JSX.Element
  83. // renderComponentContent?: (form: any) => JSX.Element
  84. }
  85. interface CompAttributes {
  86. clearable?: boolean // 是否可清空
  87. showPassword?: boolean // 是否显示切换密码图标
  88. enum?: EnumProps[] | Ref<EnumProps[]> | ((params?: any) => Promise<any>) // 枚举字典
  89. value?: string | number | boolean | any[] // 选项框值
  90. enumKey?: string
  91. labelKey?: string
  92. valueKey?: string
  93. children?: string
  94. placeholder?: string
  95. data?: Record<string, any>[]
  96. multiple?: boolean
  97. disabled?: boolean
  98. elTagName?: ElTagName
  99. type?: string
  100. rangeSeparator?: string // 时间范围分隔符
  101. startPlaceholder?: string // 开始时间Placeholder
  102. endPlaceholder?: string // 开始时间Placeholder
  103. step?: number // 滑块
  104. max?: number
  105. min?: number
  106. rows?: number
  107. filterable?: boolean
  108. allowCreate?: boolean
  109. valueFormat?: string
  110. props?: Record<string, any>
  111. width?: string | number
  112. style?: Record<string, any> | string
  113. appendToBody?: boolean // 树下拉
  114. checkStrictly?: boolean // 可选
  115. renderAfterExpand?: boolean // 可选
  116. controlsPosition?: 'left' | 'right' // 可选
  117. onChange?: (value: any) => void
  118. onSelect?: (value: any) => void
  119. onRemove?: (value: any) => void
  120. onClear?: () => void
  121. onFocus?: () => void
  122. onBlur?: () => void
  123. onInput?: (value: any) => void
  124. onSearch?: (value: any) => void
  125. onVisibleChange?: (value: any) => void
  126. onExpand?: (value: any) => void
  127. onCheck?: (value: any) => void
  128. }
  129. }