points-mall-miniprogram/miniprogram/miniprogram_npm/tdesign-miniprogram/upload

:: 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	-