這次帶給大家vux uploader 圖片上傳元件使用教程,vux uploader 圖片上傳元件使用的注意事項有哪些,下面就是實戰案例,一起來看一下。
1.網址: https://github.com/greedying/vux-uploader
2.安裝
npm install vux-uploader --save npm install --save-dev babel-preset-es2015 .babelrc { "presets": [ ["env", { "modules": false, "targets": { "browsers": ["> 1%", "last 2 versions", "not ie <= 8"] } }], "es2015", "stage-2" ], "plugins": ["transform-runtime"], "env": { "test": { "presets": ["env", "es2015", "stage-2"], "plugins": ["istanbul"] } } }
#3.使用
// 引入组件 import Uploader from 'vux-uploader' // 子组件 export default { ... components: { ... Uploader, ... } ... } // 使用组件 <uploader :max="varmax" :images="images" :handle-click="true" :show-header="false" :readonly="true" :upload-url="uploadUrl" name="img" :params="params" size="small" @preview="previewMethod" @add-image="addImageMethod" @remove-image="removeImageMethod" ></uploader>
參數說明:
#相信看了本文案例你已經掌握了方法,更多精彩請關注php中文網其它相關文章! 推薦閱讀:images
類型: Array
預設值: [],空白數組
意義: 圖片數組,格式為[ { url: '/url/of/img.ong' }, ...]
備註: 變數為陣列時,資料流為雙向,在元件內部改變陣列的值影響父元件
max
類型: Number
預設值: 1
意義: 圖片最大張數
備註: 圖片達到max值時,新增按鈕消失
showHeader
類型: Boolean
預設值: true
意義: 是否顯示頭部
備註: 控制整個頭部的顯示
title
類型: String
預設值: 圖片上傳
意義: 頭部的標題
備註: 不顯示則留空
showTip
類型: Boolean
預設值: true
意義: 是否顯示頭部數字部分,即1/3部分
備註: 當showHeader為false時,header整體隱藏,此時本參數無效
readonly
類型: Boolean
預設值: false
意義: 是否只讀
備註: 只讀時,新增和刪除按鈕隱藏
handleClick
類型: Boolean
# 預設值: false
意義: 是否接管新增按鈕的點擊事件,如果是,點選新增按鈕不再自動出現選擇圖片介面
備註: true時,點選新增按鈕,則$emit( 'add-image'),可以在此事件內進行自訂的選擇圖片等操作,此後圖片的新增、上傳、刪除都由用戶接管
autoUpload
類型: Boolean
預設值: true
意義: 選擇圖片後是否自動上傳。是,則呼叫內部上傳介面。否,則$emit('upload-image', formData)',formData`為圖片內容,使用者可監聽事件自行上傳
備註: handleClick為true時,無法進行圖片選擇,故此參數無效。此參數為false時,選擇圖片後,$emit('upload-image', formData)',formData`為圖片內容
uploadUrl
類型: String
預設值: ''
# 意義: 接收上傳圖片的url
備註: 需要回傳以下格式的json字串#,否則請設定autoUpload為false自行上傳
{
# result: "result不是0時候的
錯誤訊息", data: {
url: "http://image.url.com/image.png"
url: "http://image.url.com/image.png"
url: "http://image.url.com/image.png"##o url: "http://image.url.com/image.png"
##name
類型: String
預設值: img
意義: 預設上傳的時候,圖片使用的表單name
備註: 無
params
類型: Object
預設值: null
意義: 上傳檔案時攜帶參數
備註: 無
size
類型: String
預設值: normal
意義: 尺寸類型
of 備註: normal為weui預設尺寸,small為作者定義的小一些的尺寸
capture
類型: String
預設值: ''
意義: input 的capture屬性
備註: 可以設定為camera,此時點選新增按鈕,部分機型會直接調起相機,注意,各型號手機表現不同,請謹慎使用。當handleClick為true時,此屬性無效
emit事件說明
add-image
emit時機: 當handleClick參數為true時,點選新增按鈕
參數: 無
備註: 無
remove-image
emit時機: 當handleClick參數為true時,點選刪除按鈕
參數: 無
備註: 當handleClick為false時,點選刪除按鈕,元件內部刪除第一張圖片;否則,使用者需要監聽本事件,並進行相應刪除操作
preview
emit時機: 點擊任一張圖片的時候
參數: 圖片對象,格式為{ url: 'imgUrl' }
備註: 暫時沒有實現自動預覽功能,如果需要用戶監聽事件自行實現
upload-image
emit時機: handleClick和autoUpload都為false`時,選擇圖片
參數: formData, 圖片內容生成的formData
備註: 可以透過vm.$refs.input取得圖片的input元素
以上是vux uploader 圖片上傳元件使用教學課程的詳細內容。更多資訊請關注PHP中文網其他相關文章!