interface.d.ts 7.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. import type { RcFile as OriRcFile, UploadRequestOption as RcCustomRequestOptions } from '../vc-upload/interface';
  2. import type { ProgressProps } from '../progress';
  3. import type { VueNode } from '../_util/type';
  4. import type { ExtractPropTypes, PropType, CSSProperties } from 'vue';
  5. export interface FileType extends OriRcFile {
  6. readonly lastModifiedDate: Date;
  7. }
  8. export declare type UploadFileStatus = 'error' | 'success' | 'done' | 'uploading' | 'removed';
  9. export interface HttpRequestHeader {
  10. [key: string]: string;
  11. }
  12. export interface UploadFile<T = any> {
  13. uid: string;
  14. size?: number;
  15. name: string;
  16. fileName?: string;
  17. lastModified?: number;
  18. lastModifiedDate?: Date;
  19. url?: string;
  20. status?: UploadFileStatus;
  21. percent?: number;
  22. thumbUrl?: string;
  23. originFileObj?: FileType;
  24. response?: T;
  25. error?: any;
  26. linkProps?: any;
  27. type?: string;
  28. xhr?: T;
  29. preview?: string;
  30. }
  31. export interface InternalUploadFile<T = any> extends UploadFile<T> {
  32. originFileObj: FileType;
  33. }
  34. export interface ShowUploadListInterface {
  35. showRemoveIcon?: boolean;
  36. showPreviewIcon?: boolean;
  37. showDownloadIcon?: boolean;
  38. }
  39. export interface UploadChangeParam<T = UploadFile> {
  40. file: T;
  41. fileList: UploadFile[];
  42. event?: {
  43. percent: number;
  44. };
  45. }
  46. export interface UploadLocale {
  47. uploading?: string;
  48. removeFile?: string;
  49. downloadFile?: string;
  50. uploadError?: string;
  51. previewFile?: string;
  52. }
  53. export declare type UploadType = 'drag' | 'select';
  54. export declare type UploadListType = 'text' | 'picture' | 'picture-card';
  55. export declare type UploadListProgressProps = Omit<ProgressProps, 'percent' | 'type'> & {
  56. class?: string;
  57. style?: CSSProperties;
  58. };
  59. export declare type ItemRender<T = any> = (opt: {
  60. originNode: VueNode;
  61. file: UploadFile;
  62. fileList: Array<UploadFile<T>>;
  63. actions: {
  64. download: () => void;
  65. preview: () => void;
  66. remove: () => void;
  67. };
  68. }) => VueNode;
  69. declare type PreviewFileHandler = (file: FileType | Blob) => PromiseLike<string>;
  70. declare type TransformFileHandler = (file: FileType) => string | Blob | FileType | PromiseLike<string | Blob | FileType>;
  71. declare type BeforeUploadValueType = void | boolean | string | Blob | FileType;
  72. declare function uploadProps<T = any>(): {
  73. capture: PropType<boolean | "user" | "environment">;
  74. type: PropType<UploadType>;
  75. name: StringConstructor;
  76. defaultFileList: PropType<UploadFile<T>[]>;
  77. fileList: PropType<UploadFile<T>[]>;
  78. action: PropType<string | ((file: FileType) => string) | ((file: FileType) => PromiseLike<string>)>;
  79. directory: {
  80. type: BooleanConstructor;
  81. default: any;
  82. };
  83. data: PropType<Record<string, unknown> | ((file: UploadFile<T>) => Record<string, unknown> | Promise<Record<string, unknown>>)>;
  84. method: PropType<"post" | "POST" | "PUT" | "PATCH" | "put" | "patch">;
  85. headers: PropType<HttpRequestHeader>;
  86. showUploadList: {
  87. type: PropType<boolean | ShowUploadListInterface>;
  88. default: boolean | ShowUploadListInterface;
  89. };
  90. multiple: {
  91. type: BooleanConstructor;
  92. default: any;
  93. };
  94. accept: StringConstructor;
  95. beforeUpload: PropType<(file: FileType, FileList: FileType[]) => BeforeUploadValueType | Promise<BeforeUploadValueType>>;
  96. onChange: PropType<(info: UploadChangeParam<UploadFile<T>>) => void>;
  97. 'onUpdate:fileList': PropType<(fileList: UploadChangeParam<UploadFile<T>>['fileList']) => void>;
  98. onDrop: PropType<(event: DragEvent) => void>;
  99. listType: PropType<UploadListType>;
  100. onPreview: PropType<(file: UploadFile<T>) => void>;
  101. onDownload: PropType<(file: UploadFile<T>) => void>;
  102. onReject: PropType<(fileList: FileType[]) => void>;
  103. onRemove: PropType<(file: UploadFile<T>) => void | boolean | Promise<void | boolean>>;
  104. /** @deprecated Please use `onRemove` directly */
  105. remove: PropType<(file: UploadFile<T>) => void | boolean | Promise<void | boolean>>;
  106. supportServerRender: {
  107. type: BooleanConstructor;
  108. default: any;
  109. };
  110. disabled: {
  111. type: BooleanConstructor;
  112. default: any;
  113. };
  114. prefixCls: StringConstructor;
  115. customRequest: PropType<(options: RcCustomRequestOptions) => void>;
  116. withCredentials: {
  117. type: BooleanConstructor;
  118. default: any;
  119. };
  120. openFileDialogOnClick: {
  121. type: BooleanConstructor;
  122. default: any;
  123. };
  124. locale: {
  125. type: PropType<UploadLocale>;
  126. default: UploadLocale;
  127. };
  128. id: StringConstructor;
  129. previewFile: PropType<PreviewFileHandler>;
  130. /** @deprecated Please use `beforeUpload` directly */
  131. transformFile: PropType<TransformFileHandler>;
  132. iconRender: PropType<(opt: {
  133. file: UploadFile<T>;
  134. listType?: UploadListType;
  135. }) => VueNode>;
  136. isImageUrl: PropType<(file: UploadFile) => boolean>;
  137. progress: PropType<UploadListProgressProps>;
  138. itemRender: PropType<ItemRender<T>>;
  139. /** Config max count of `fileList`. Will replace current one when `maxCount` is 1 */
  140. maxCount: NumberConstructor;
  141. height: (StringConstructor | NumberConstructor)[];
  142. removeIcon: PropType<(opt: {
  143. file: UploadFile;
  144. }) => VueNode>;
  145. downloadIcon: PropType<(opt: {
  146. file: UploadFile;
  147. }) => VueNode>;
  148. previewIcon: PropType<(opt: {
  149. file: UploadFile;
  150. }) => VueNode>;
  151. };
  152. export declare type UploadProps = Partial<ExtractPropTypes<ReturnType<typeof uploadProps>>>;
  153. export interface UploadState<T = any> {
  154. fileList: UploadFile<T>[];
  155. dragState: string;
  156. }
  157. declare function uploadListProps<T = any>(): {
  158. listType: PropType<UploadListType>;
  159. onPreview: PropType<(file: UploadFile<T>) => void>;
  160. onDownload: PropType<(file: UploadFile<T>) => void>;
  161. onRemove: PropType<(file: UploadFile<T>) => void | boolean>;
  162. items: PropType<UploadFile<T>[]>;
  163. progress: PropType<UploadListProgressProps>;
  164. prefixCls: PropType<string>;
  165. showRemoveIcon: {
  166. type: BooleanConstructor;
  167. default: any;
  168. };
  169. showDownloadIcon: {
  170. type: BooleanConstructor;
  171. default: any;
  172. };
  173. showPreviewIcon: {
  174. type: BooleanConstructor;
  175. default: any;
  176. };
  177. removeIcon: PropType<(opt: {
  178. file: UploadFile;
  179. }) => VueNode>;
  180. downloadIcon: PropType<(opt: {
  181. file: UploadFile;
  182. }) => VueNode>;
  183. previewIcon: PropType<(opt: {
  184. file: UploadFile;
  185. }) => VueNode>;
  186. locale: {
  187. type: PropType<UploadLocale>;
  188. default: UploadLocale;
  189. };
  190. previewFile: PropType<PreviewFileHandler>;
  191. iconRender: PropType<(opt: {
  192. file: UploadFile<T>;
  193. listType?: UploadListType;
  194. }) => VueNode>;
  195. isImageUrl: PropType<(file: UploadFile) => boolean>;
  196. appendAction: PropType<() => VueNode>;
  197. appendActionVisible: {
  198. type: BooleanConstructor;
  199. default: any;
  200. };
  201. itemRender: PropType<ItemRender<T>>;
  202. };
  203. export declare type UploadListProps = Partial<ExtractPropTypes<ReturnType<typeof uploadListProps>>>;
  204. export { uploadProps, uploadListProps };