Function showFileUpload

showFileUpload(ctx, options): Promise<MwFile[] | null>

Experimental

Displays a file upload bubble and returns an array of MwFile objects containing the selected files' data and metadata.

Parameters

ctx: Context
The context object that provides access to the render method.
options: ShowFileUploadOptions
The options to configure the file upload dialog.

Returns Promise<MwFile[] | null>

A promise that resolves with an array of MwFile objects, or null if the user cancels the dialog.

Warning

Be cautious with the validate function, especially when handling large Excel files. Reading large files can take a considerable amount of time and significantly affect performance. Ensure that file validations are efficient to avoid blocking the UI or causing long delays.

Example

const options: ShowFileUploadOptions = {
   fileUploadTitle: 'Upload Files',
   uploadButton: 'Upload',
   fileUploadText: 'Please select file to upload.',
   minFileLimit: 1,
   maxFileLimit: 3,
   overlay: true,
   overlayProps: {
     blur: true,
     blurIntensity: 10,
     background: 'grey',
   }
   error: 'You can upload up to 3 files only.',
   validate: async (file) => {
     if (file.type !== 'application/pdf') {
       return {isValid: false, message: 'File type must be PDF.'};
     }
     return {isValid: true, message: ''};
   },
 };
 const selectedFiles = await showFileUpload(ctx, options);
if (selectedFiles) {
  // Process the selected files.
}