vue-image-crop-upload

中文文档.

A beautiful vue component for image crop and upload.

Notice: This component is designed for pc, not recommended for use on the mobile side.



Change log

#### @3.0.0
- Compatible vue3

Demo

Click me.

Screenshot

!screenshot

Brower compatibility

IE10+

Install

#### npm
``shell
$ npm install vue-image-crop-upload
`

Usage

#### Props
| Name | Type | Default | Description |
| ----------------| ---------------- | ---------------| ------------------------------------------|
| url | String | '' | Server api path,like "/avatar/upload", If empty, will not be uploaded |
| method | String | 'POST' | request http method |
| field | String | 'upload' | Upload input filename, used for server side get the file stream. |
| value | Boolean | twoWay | show or not |
| params | Object | null | POST Params，like "{k:v}" |
| headers | Object | null | POST request header，like "{k:v}" |
| langType | String | 'zh' | language type |
| langExt | Object | | language extend |
| width | Number | 200 | width of receive image |
| height | Number | 200 | height of receive image |
| imgFormat | string | 'png' | jpg/png, Server api receive file type. |
| imgBgc | string | '#fff' | background color, if the imgFormat prop is jpg |
| noCircle | Boolean | false | disable circle preview |
| noSquare | Boolean | false | disable square preview |
| noRotate | Boolean | true | disable rotate function |
| withCredentials | Boolean | false | support cross-domain |

#### Events
| Name | Description |
| ----------------| ------------------------------------------|
| srcFileSet |Once you've selected the file, params( fileName, fileType, fileSize ) |
| cropSuccess | image crop success, params( imageDataUrl, field ) |
| cropUploadSuccess | upload success, params( jsonData, field ) |
| cropUploadFail | upload fail, params( status, field ) |

#### Language package
view details.

#### Example Of "langExt"
`js
{
hint: 'Click or drag the file here to upload',
loading: 'Uploading…',
noSupported: 'Browser is not supported, please use IE10+ or other browsers',
success: 'Upload success',
fail: 'Upload failed',
preview: 'Preview',
btn: {
off: 'Cancel',
close: 'Close',
back: 'Back',
save: 'Save'
},
error: {
onlyImg: 'Image only',
outOfSize: 'Image exceeds size limit: ',
lowestPx: 'Image\'s size is too low. Expected at least: '
}
}
`

#### Example vue@3
`html



`

#### Example vue@2
`html



`

#### Example vue@1
`html



``