這篇文章主要介紹了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>
參數說明:
相關推薦:#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: 0,
錯誤訊息",
data: {
url: "http://image.url.com/image.png"
}
# } # 預設值: img
意義: 預設上傳的時候,圖片使用的表單name
備註: 無
params
類型: Object
# 預設值: null
意義: 上傳檔案時攜帶參數
備註: 無
size
類型: String
預設值: normal
意義: 尺寸類型
備註: 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元素
以上就是本文的全部內容,希望對大家的學習有所幫助,更相關內容請關注PHP中文網!
以上是關於vux uploader 圖片上傳元件的安裝使用方法的詳細內容。更多資訊請關注PHP中文網其他相關文章!