1.網(wǎng)址： 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>

參數(shù)說明：

images
  類型: Array
  默認(rèn)值: []，空數(shù)組
  含義: 圖片數(shù)組，格式為 [ { url: '/url/of/img.ong' }, ...]
  備注: 變量為數(shù)組時(shí)，數(shù)據(jù)流為雙向，在組件內(nèi)部改變數(shù)組的值影響父組件
max
  類型: Number
  默認(rèn)值: 1
  含義: 圖片最大張數(shù)
  備注: 圖片達(dá)到max值時(shí)，新增按鈕消失
showHeader
  類型: Boolean
  默認(rèn)值: true
  含義: 是否顯示頭部
  備注: 控制整個(gè)頭部的顯示
title
  類型: String
  默認(rèn)值: 圖片上傳
  含義: 頭部的標(biāo)題
  備注: 不顯示則留空
showTip
  類型: Boolean
  默認(rèn)值: true
  含義: 是否顯示頭部數(shù)字部分，即1/3部分
  備注: 當(dāng)showHeader為false時(shí)，header整體隱藏，此時(shí)本參數(shù)無效
readonly
  類型: Boolean
  默認(rèn)值: false
  含義: 是否只讀
  備注: 只讀時(shí)，新增和刪除按鈕隱藏
handleClick
  類型: Boolean
  默認(rèn)值: false
  含義: 是否接管新增按鈕的點(diǎn)擊事件，如果是，點(diǎn)擊新增按鈕不再自動(dòng)出現(xiàn)選擇圖片界面
  備注: true時(shí)，點(diǎn)擊新增按鈕，則$emit('add-image')，可以在此事件內(nèi)進(jìn)行自定義的選擇圖片等操作,此后圖片的新增、上傳、刪除都由使用者接管
autoUpload
  類型: Boolean
  默認(rèn)值: true
  含義: 選擇圖片后是否自動(dòng)上傳。是，則調(diào)用內(nèi)部上傳接口。否，則$emit('upload-image', formData)',formData`為圖片內(nèi)容，用戶可監(jiān)聽事件自己上傳
  備注: handleClick為true時(shí)，無法進(jìn)行圖片選擇，故此參數(shù)無效。此參數(shù)為false時(shí)，選擇圖片后,$emit('upload-image', formData)',formData`為圖片內(nèi)容
uploadUrl
  類型: String
  默認(rèn)值: ''
  含義: 接收上傳圖片的url
  備注: 需要返回如下格式的json字符串，否則請(qǐng)?jiān)O(shè)置autoUpload為false自行上傳
    {
      result: 0,
      message: "result不是0時(shí)候的錯(cuò)誤信息",
      data: {
        url: "       }
    }
name
  類型: String
  默認(rèn)值: img
  含義: 默認(rèn)上傳的時(shí)候，圖片使用的表單name
  備注: 無
params
  類型: Object
  默認(rèn)值: null
  含義: 上傳文件時(shí)攜帶參數(shù)
  備注: 無
size
  類型: String
  默認(rèn)值: normal
  含義: 尺寸類型
  備注: normal為weui默認(rèn)尺寸，small為作者定義的小一些的尺寸
capture
  類型: String
  默認(rèn)值: ''
  含義: input 的capture屬性
  備注: 可以設(shè)置為camera，此時(shí)點(diǎn)擊新增按鈕，部分機(jī)型會(huì)直接調(diào)起相機(jī)，注意，各型號(hào)手機(jī)表現(xiàn)不同，請(qǐng)謹(jǐn)慎使用。handleClick為true時(shí)，此屬性無效
  emit事件說明
add-image
  emit時(shí)機(jī): 當(dāng)handleClick參數(shù)為true時(shí)，點(diǎn)擊新增按鈕
  參數(shù): 無
  備注: 無
remove-image
  emit時(shí)機(jī): 當(dāng)handleClick參數(shù)為true時(shí)，點(diǎn)擊刪除按鈕
  參數(shù): 無
  備注: 當(dāng)handleClick為false時(shí)，點(diǎn)擊刪除按鈕，組件內(nèi)部刪除第一張圖片；否則，用戶需要監(jiān)聽本事件，并進(jìn)行相應(yīng)刪除操作
preview
  emit時(shí)機(jī): 點(diǎn)擊任意一張圖片的時(shí)候
  參數(shù): 圖片對(duì)象，格式為 { url: 'imgUrl' }
  備注: 暫時(shí)沒有實(shí)現(xiàn)自動(dòng)預(yù)覽功能，如果需要用戶監(jiān)聽事件自行實(shí)現(xiàn)
upload-image
  emit時(shí)機(jī): handleClick和autoUpload都為false`時(shí)，選擇圖片
  參數(shù): formData,圖片內(nèi)容生成的formData
  備注: 可以通過vm.$refs.input獲取圖片的input元素

最新評(píng)論