ProForm.d.ts 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
  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. | 'imgs-upload'
  30. | 'file-upload-s3'
  31. | 'imgs-upload-s3'
  32. | 'slot'
  33. | 'rate'
  34. | 'slider'
  35. | 'switch'
  36. | 'time-picker'
  37. | 'time-select'
  38. | 'transfer' // label不显示 使用插槽吧
  39. | 'icon' // 图标
  40. interface FormOptions {
  41. inline?: boolean
  42. labelWidth?: string | number
  43. labelPosition?: 'left' | 'right' | 'top'
  44. disabled?: boolean // 不可编辑
  45. hasFooter?: boolean // 是否显示底部操作按钮
  46. labelSuffix?: ': ' | string
  47. showResetButton?: boolean // 是否展示重置按钮
  48. showCancelButton?: boolean // 是否展示取消按钮
  49. submitButtonText?: string
  50. resetButtonText?: string
  51. cancelButtonText?: string
  52. blockSubmitButton?: boolean // 提交按钮是否以块级按钮呈现
  53. }
  54. interface ItemsOptions {
  55. /** form-item 配置项 */
  56. label?: string
  57. labelWidth?: string | number // 标签宽度,例如 '50px'。 可以使用 auto。
  58. prop: string // prop
  59. tooltip?: string // 问号,tooltip提示
  60. required?: boolean
  61. hideLabelSuffix?: boolean // label后缀是否隐藏
  62. rules?: FormItemRule[]
  63. span?: number // 表单col宽度
  64. show?: (params?: any) => Promise<any> | boolean | string // 是否显示 默认显示
  65. /** 表单组件配置项 */
  66. compOptions: CompAttributes // 表单组件配置项
  67. }
  68. interface FormItem {
  69. label?: string
  70. labelWidth?: string | number // 标签宽度,例如 '50px'。 可以使用 auto。
  71. prop: string // prop
  72. value?: any // 默认值
  73. tooltip?: string // 问号,tooltip提示
  74. required?: boolean
  75. rules?: FormItemRule[]
  76. span?: number // 表单col宽度
  77. show?: (params?: any) => Promise<any> | boolean | string // 是否显示 默认显示
  78. // showLabel?: boolean // 是否显示label
  79. // showHelp?: boolean // 是否显示帮助信息
  80. // helpMessage?: string | string[]
  81. // render?: (form: any) => JSX.Element
  82. // renderFormItem?: (form: any) => JSX.Element
  83. // renderComponent?: (form: any) => JSX.Element
  84. // renderComponentContent?: (form: any) => JSX.Element
  85. }
  86. interface CompAttributes {
  87. clearable?: boolean // 是否可清空
  88. showPassword?: boolean // 是否显示切换密码图标
  89. enum?: EnumProps[] | Ref<EnumProps[]> | ((params?: any) => Promise<any>) // 枚举字典
  90. value?: string | number | boolean | any[] // 选项框值
  91. enumKey?: string
  92. labelKey?: string
  93. valueKey?: string
  94. children?: string
  95. placeholder?: string
  96. data?: Record<string, any>[]
  97. multiple?: boolean
  98. disabled?: boolean
  99. elTagName?: ElTagName
  100. type?: string
  101. rangeSeparator?: string // 时间范围分隔符
  102. startPlaceholder?: string // 开始时间Placeholder
  103. endPlaceholder?: string // 开始时间Placeholder
  104. step?: number // 滑块
  105. max?: number
  106. min?: number
  107. rows?: number
  108. filterable?: boolean
  109. allowCreate?: boolean
  110. valueFormat?: string
  111. props?: Record<string, any>
  112. width?: string | number
  113. style?: Record<string, any> | string
  114. appendToBody?: boolean // 树下拉
  115. checkStrictly?: boolean // 可选
  116. renderAfterExpand?: boolean // 可选
  117. controlsPosition?: 'left' | 'right' // 可选
  118. onChange?: (value: any) => void
  119. onSelect?: (value: any) => void
  120. onRemove?: (value: any) => void
  121. onClear?: () => void
  122. onFocus?: () => void
  123. onBlur?: () => void
  124. onInput?: (value: any) => void
  125. onSearch?: (value: any) => void
  126. onVisibleChange?: (value: any) => void
  127. onExpand?: (value: any) => void
  128. onCheck?: (value: any) => void
  129. }
  130. }