| | |
|---|
| | | add-content | String / Slot | - | \- | N |
|---|
| | | allow-upload-duplicate-file | Boolean | false | \- | N |
|---|
| | | config | Object | - | Typescript：`UploadMpConfig` `type UploadMpConfig = ImageConfig \| VideoConfig` `interface ImageConfig { count?: number; sizeType?: Array<SizeTypeValues>; sourceType?: Array<SourceTypeValues> }` `type SizeTypeValues = 'original' \| 'compressed'` `type SourceTypeValues = 'album' \| 'camera'` `interface VideoConfig { sourceType?: Array<SourceTypeValues>; compressed?: boolean; maxDuration?: number; camera?: 'back' \| 'front' }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | disabled | Boolean | false | \- | N |
|---|
| | | file-list-display | Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | files | Array | - | Typescript：`Array<UploadFile>` `interface UploadFile { url: string; name?: string; size?: number; type?: 'image' \| 'video'; percent?: number; status: 'loading' \| 'reload' \| 'failed' \| 'done' }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | default-files | Array | undefined | uncontrolled property。Typescript：`Array<UploadFile>` `interface UploadFile { url: string; name?: string; size?: number; type?: 'image' \| 'video'; percent?: number; status: 'loading' \| 'reload' \| 'failed' \| 'done' }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | files | Array | - | Typescript：`Array<UploadFile>` `interface UploadFile { url: string; name?: string; size?: number; type?: 'image' \| 'video'; percent?: number; status: 'loading' \| 'reload' \| 'failed' \| 'done'; thumb?: string }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | default-files | Array | undefined | uncontrolled property。Typescript：`Array<UploadFile>` `interface UploadFile { url: string; name?: string; size?: number; type?: 'image' \| 'video'; percent?: number; status: 'loading' \| 'reload' \| 'failed' \| 'done'; thumb?: string }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | grid-config | Object | - | Typescript：`{column?: number; width?: number; height?: number;}` | N |
|---|
| | | gutter | Number | 16 | \- | N |
|---|
| | | image-props | Object | - | Typescript：`ImageProps`，[Image API Documents](./image?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | |
|---|
| | | request-method | Function | - | \- | N |
|---|
| | | size-limit | Number / Object | - | Typescript：`number \| SizeLimitObj` `interface SizeLimitObj { size: number; unit: SizeUnit ; message?: string }` `type SizeUnitArray = ['B', 'KB', 'MB', 'GB']` `type SizeUnit = SizeUnitArray[number]`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | source | String | media | options：media/messageFile | N |
|---|
| | | draggable | Boolean / Object | - | Does it support drag and drop sorting. Whether it vibrates during long periods of time and whether it vibrates during collisions。。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | transition | Object | `{ backTransition: true, duration: 300, timingFunction: 'ease' }` | Transition parameters when dragging and moving positions。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts) | N |
|---|
| | | |
|---|
| | | ### Upload Events |
|---|
| | | |
|---|
| | |
|---|
| | | remove | `(index: number; file: UploadFile)` | \- |
|---|
| | | select-change | `(currentSelectedFiles: MediaContext[])` | \- |
|---|
| | | success | `(files: MediaContext)` | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts)。<br/>`type MediaContext = VideoContext[] \| ImageContext[]`<br/><br/>`interface VideoContext { name?: string; type?: string; url?: string; duration?: number; size?: number; width?: number; height?: number; thumb: string; progress: number }`<br/><br/>`interface ImageContext { name: string; type: string; url: string; size: number; width: number; height: number; progress: number }`<br/> |
|---|
| | | click | `(file: VideoContext \| ImageContext)` | - |
|---|
| | | drop | `(files: MediaContext)` | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/upload/type.ts)。<br/>`type MediaContext = VideoContext[] \| ImageContext[]`<br/><br/>`interface VideoContext { name?: string; type?: string; url?: string; duration?: number; size?: number; width?: number; height?: number; thumb: string; progress: number }`<br/><br/>`interface |
|---|
| | | ImageContext { name: string; type: string; url: string; size: number; width: number; height: number; progress: number }`<br/> |
|---|
| | | |
|---|
| | | |
|---|
| | | ### CSS Variables |
|---|
| | | The component provides the following CSS variables, which can be used to customize styles. |
|---|
| | | Name | Default Value | Description |
|---|
| | | -- | -- | -- |
|---|
| | | --td-upload-add-bg-color | @bg-color-secondarycontainer | - |
|---|
| | | --td-upload-add-color | @font-gray-3 | - |
|---|
| | | --td-upload-add-disabled-bg-color | @bg-color-component-disabled | - |
|---|
| | | --td-upload-add-icon-disabled-color | @text-color-disabled | - |
|---|
| | | --td-upload-add-icon-font-size | 56rpx | - |
|---|
| | | --td-upload-disabled-mask | rgba(255, 255, 255, 0.55) | - |
|---|
| | | --td-upload-radius | @radius-default | - |
|---|
| | | --td-upload-drag-z-index | 999 | - |
|---|
