| .. | ||
| props.d.ts | ||
| props.js | ||
| README.en-US.md | ||
| README.md | ||
| type.d.ts | ||
| type.js | ||
| upload-info.json | ||
| upload.d.ts | ||
| upload.js | ||
| upload.json | ||
| upload.wxml | ||
| upload.wxs | ||
| upload.wxss | ||
:: BASE_DOC ::
API
Upload Props
| name | type | default | description | required |
|---|---|---|---|---|
| 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 |
N |
| file-list-display | Slot | - | see more ts definition | 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 |
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 |
N |
| grid-config | Object | - | Typescript：{column?: number; width?: number; height?: number;} |
N |
| gutter | Number | 16 | - | N |
| image-props | Object | - | Typescript：ImageProps，Image API Documents。see more ts definition |
N |
| max | Number | 0 | - | N |
| media-type | Array | ['image', 'video'] | Typescript：Array<MediaType> type MediaType = 'image' | 'video'。see more ts definition |
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 |
N |
| source | String | media | options：media/messageFile | N |
Upload Events
| name | params | description |
|---|---|---|
| add | (files: MediaContext) |
see more ts definition。type MediaContext = VideoContext[] | ImageContext[]interface VideoContext { name?: string; type?: string; url?: string; duration?: number; size?: number; width?: number; height?: number; thumb: string; progress: number }interface ImageContext { name: string; type: string; url: string; size: number; width: number; height: number; progress: number } |
| complete | - | - |
| fail | - | - |
| remove | (index: number; file: UploadFile) |
- |
| select-change | (currentSelectedFiles: MediaContext[]) |
- |
| success | (files: MediaContext) |
see more ts definition。type MediaContext = VideoContext[] | ImageContext[]interface VideoContext { name?: string; type?: string; url?: string; duration?: number; size?: number; width?: number; height?: number; thumb: string; progress: number }interface ImageContext { name: string; type: string; url: string; size: number; width: number; height: number; progress: number } |
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-icon-font-size | 56rpx | - |
| --td-upload-radius | @radius-default | - |