quasar

{ "mixins": [ "components/uploader/QUploaderBase" ], "meta": { "docsUrl": "https://v1.quasar.dev/vue-components/uploader" }, "props": { "factory": { "type": "Function", "desc": "Function which should return an Object or a Promise resolving with an Object; For best performance, reference it from your scope and do not define it inline", "params": { "files": { "type": "Array", "desc": "Uploaded files", "__exemption": [ "examples" ] } }, "returns": { "type": [ "Object", "Promise" ], "desc": "Optional configuration for the upload process; You can override QUploader props in this Object (url, method, headers, formFields, fieldName, withCredentials, sendRaw); Props of these Object can also be Functions with the form of (file[s]) => value", "__exemption": [ "examples" ] }, "category": "upload" }, "url": { "type": [ "String", "Function" ], "desc": "URL or path to the server which handles the upload. Takes String or factory function, which returns String. Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "examples": [ "https://example.com/path", "files => `https://example.com?count=${files.length}`" ], "category": "upload" }, "method": { "type": [ "String", "Function" ], "default": "POST", "desc": "HTTP method to use for upload; Takes String or factory function which returns a String; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "values": [ "POST", "PUT" ], "examples": [ "POST", ":method=\"files => files.length > 10 ? 'POST' : 'PUT'\"" ], "category": "upload" }, "field-name": { "type": [ "String", "Function" ], "desc": "Field name for each file upload; This goes into the following header: 'Content-Disposition: form-data; name=\"__HERE__\"; filename=\"somefile.png\"; If using a function then for best performance, reference it from your scope and do not define it inline", "default": "(file) => file.name", "examples": [ "backgroundFile", ":field-name=\"(file) => 'background' + file.name\"" ], "category": "upload" }, "headers": { "type": [ "Array", "Function" ], "desc": "Array or a factory function which returns an array; Array consists of objects with header definitions; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "definition": { "name": { "type": "String", "required": true, "desc": "Header name", "examples": [ "Content-Type", "Accept", "Cache-Control" ] }, "value": { "type": "String", "required": true, "desc": "Header value", "examples": [ "application/json", "no-cache" ] } }, "examples": [ "[{name: 'Content-Type', value: 'application/json'}, {name: 'Accept', value: 'application/json'}]", "() => [{name: 'X-Custom-Timestamp', value: Date.now()}]", "files => [{name: 'X-Custom-Count', value: files.length}]" ], "category": "upload" }, "form-fields": { "type": [ "Array", "Function" ], "desc": "Array or a factory function which returns an array; Array consists of objects with additional fields definitions (used by Form to be uploaded); Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "definition": { "name": { "type": "String", "required": true, "desc": "Field name", "examples": [ "Some field" ] }, "value": { "type": "String", "required": true, "desc": "Field value", "examples": [ "some-value" ] } }, "examples": [ "[{name: 'my-field', value: 'my-value'}]", "() => [{name: 'my-field', value: 'my-value'}]", "files => [{name: 'my-field', value: 'my-value' + files.length}]" ], "category": "upload" }, "with-credentials": { "type": [ "Boolean", "Function" ], "desc": "Sets withCredentials to true on the XHR that manages the upload; Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "examples": [ "with-credentials", ":with-credentials=\"files => ...\"" ], "category": "upload" }, "send-raw": { "type": [ "Boolean", "Function" ], "desc": "Send raw files without wrapping into a Form(); Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "examples": [ "send-raw", ":send-raw=\"files => ...\"" ], "category": "upload" }, "batch": { "type": [ "Boolean", "Function" ], "desc": "Upload files in batch (in one XHR request); Takes boolean or factory function for Boolean; Function is called right before upload; If using a function then for best performance, reference it from your scope and do not define it inline", "examples": [ "files => files.length > 10" ], "category": "upload" } }, "events": { "uploaded": { "desc": "Emitted when file or batch of files is uploaded", "params": { "info": { "type": "Object", "desc": "Object containing information about the event", "definition": { "files": { "type": "Array", "desc": "Uploaded files", "__exemption": [ "examples" ] }, "xhr": { "type": "Object", "desc": "XMLHttpRequest that has been used to upload this batch of files", "__exemption": [ "examples" ] } } } } }, "failed": { "desc": "Emitted when file or batch of files has encountered error while uploading", "params": { "info": { "type": "Object", "desc": "Object containing information about the event", "definition": { "files": { "type": "Array", "desc": "Files which encountered error", "__exemption": [ "examples" ] }, "xhr": { "type": "Object", "desc": "XMLHttpRequest that has been used to upload this batch of files", "__exemption": [ "examples" ] } } } } }, "uploading": { "desc": "Emitted when file or batch of files started uploading", "params": { "info": { "type": "Object", "desc": "Object containing information about the event", "definition": { "files": { "type": "Array", "desc": "Files which are now uploading", "__exemption": [ "examples" ] }, "xhr": { "type": "Object", "desc": "XMLHttpRequest used for uploading", "__exemption": [ "examples" ] } } } } }, "factory-failed": { "desc": "Emitted when factory function is supplied with a Promise which is rejected", "params": { "err": { "type": "Object", "desc": "Error Object which is the Promise rejection reason", "__exemption": [ "examples" ] }, "files": { "type": "Array", "desc": "Files which were to get uploaded", "__exemption": [ "examples" ] } } } }, "methods": { "abort": { "desc": "Abort upload of all files (same as clicking the abort button)" }, "upload": { "desc": "Start uploading (same as clicking the upload button)" } } }