@shapla/vue-file-uploader v1.0.0
Shapla File Uploader
A component for handling drag and drop file upload functionality for Vue 3.
Table of contents
Installation
npm install --save @shapla/vue-file-uploaderUsage
Styles
with Sass:
import '@shapla/vue-file-uploader/src/index.scss';with CSS:
import '@shapla/vue-file-uploader/dist/style.css';Javascript Instantiation
import ShaplaFileUploader from '@shapla/vue-file-uploader';
export default {
name: 'Hello',
components: {
ShaplaFileUploader
},
methods: {
handleSuccess(fileObject,serverResponse){
// Handle click event
}
}
}<shapla-file-uploader @success="handleSuccess"/>Props
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
url | String | yes | null | File upload url |
method | String | no | POST | File upload method |
paramName | String | no | file | File upload parameter name |
textLineOne | String | no | Drag & drop files | Placeholder first line text |
textLineTwo | String | no | or | Placeholder second line text |
textButton | String | no | Select files to upload | Button text |
textMaxUploadLimit | String | no | Maximum upload file size: 2MB | Max upload limit text |
params | Object | no | {} | An object of additional parameters to transfer to the server |
showFileUploadStatus | Boolean | no | true | If set true, individual file upload status will be shown |
showFilesUploadStatus | Boolean | no | true | If set true, all files upload status will be shown |
Listeners
The uploader component fires the following events:
init: It fires the event when a file initiate to upload. FormData pass as parameter.
before:send: It fires the event before sending data to server. XMLHttpRequest pass as first parameter and FormData pass as second parameter.
progress: It fires the event when a file upload in progress. fileObject object pass as first parameter and event pass as second parameter.
success: It fires the event when a file uploaded successfully. fileObject object pass as first parameter and serverResponse pass as second parameter.
fail: It fires the event when a file uploaded failed on server. fileObject object pass as first parameter and serverResponse pass as second parameter.
error: It fires the event when a file uploaded failed. fileObject object pass as first parameter.
<!-- template -->
<shapla-file-uploader
@before:send="handleBeforeSendEvent"
@success="handleSuccess"
/>
<!-- method -->
methods: {
handleBeforeSendEvent(xhr,formData){
// You can add custom header to xhr
xhr.setRequestHeader('Authorization', 'authorization code goes here');
},
handleSuccess(fileObject,serverResponse){
// Handle click event
}
}4 years ago