这个数字…………在这里插入图片描述

起因:

由于最近做的是CMS系统,上传文件,图片功能太多,使用element的文件上传组件,但是每次都需要写,感觉太繁琐,于是有了男人的想法………对 element 的文件上传组件进行了封装

个人认为还是挺全的,如果各位小哥有更好的建议或意见欢迎评论区提出,我会根据实际情况进行更改组件

组件已经上传到了 github 和 npm


组件优势---------->使用方便,比例(80*80),大小(MB),校验(必填项)等,一个参数搞定,记得点赞收藏哟

1:增加上传为空校验,可选择是否是必填项
2:自定义为空提示
2:增加上传图片的比例尺寸校验,例如图片:支持图片 === | >= || <= 80*80,80是使用的时候传的
3:规定文件上传大小
4:自定义上传主题:图片或文件
5:自定义上传个数
6:指定文件上传完毕后是否继续显示上传按钮
7:增加一键清空按钮,可以根据参数让他显示不显示
8:文件上传成功后,可自动对你的参数进行赋值
9:是否开启剪裁(还在开发,请持续关注)
10:Hppt: 上传的端口,本地环境,测试环境,上线环境
单选、多选、支持发送 cookie 凭证信息等

github 地址

https://github.com/jasen666/uploadmodel

npm 地址

https://www.npmjs.com/package/jasen-vue-uploadmodel

如果还不会把自己写的代码放到 npm
可以参考我的另外一篇文章:
https://blog.csdn.net/weixin_46095200/article/details/107235451

使用方法:

npm i jasen-vue-uploadmodel -S
import Vue from 'vue'
import UploadFile from 'jasen-vue-uploadmodel'
 
Vue.component('UploadFile', UploadFile)
<UploadFile
        clearButtonStyle="margin-left:80px;margin-top:10px"
        :visible="changeFormVisible"
        :Hppt="Hppt"
        :className="'My-el-form-item'"
        :fromKey="'logo'"
        @setUrlPath="SetUrlPath"
        :limit="1"
        :fileList.sync="fileListLogo"
        :label="'logo'"
      />

Api

Attributes

Namemust fillTypeDefaultDescription
acceptString".jpg, .png, .gif, .jpeg"“上传文件的类型,默认图片类型”
HpptString’ ’上传文件的端口地址(本地环境、测试环境、线上环境)
portString’ ’上传图片的地址,详细地址(/upload.json这样)
SizeNumber|Booleanfalse是否需要规定上传文件的大小
needRequiredBooleantrue是否需要为空校验
errorMessageString请上传图片文件为空提交的时候的提示
fileListArray[]文件上传的一个数组,用来存放上传文件内容 ,需要.sync支持
putSuccessShowAddBtnBooleanfalse上传成功后是否还展示,上传按钮
ProportionBoolean|Arrayfalse是否需要规定图片的尺寸比例大小
computationRuleString===进行比例对比时的规则,支持:===
listTypeStringpicture-card是上传图片,还是上传文件,图片使用:picture-card,文件使用:text
showFileListBooleantrue上传成功后是否需要上传进行展示已上传文件列表
fromKeyString|Array’ ’上传成功后,将要修改的字段名字,把后台的文件路径进行复制
limitMaxNumber2文件最大的上传个数
limitMinNumber1文件最少上传个数
showClearAllBtnBooleantrue是否展示一键清除按钮
needMultipleBooleanfalse是否支持多选
withCredentialsBooleanfalse是否上传cooike凭证
headersobject’ ’设置上传的请求头部
labelString’ ’上传图片的左侧内容:例如:上传背景图,上传商标啥啥的
clearButtonStyleStringmargin-top:10px一键清除的按钮样式
visibleBooleanfalse建议传一个动态的,当你进行回显的时候会有一个,渐显的效果,体验不是特别好,
============================================================================================

全局加上 css 用来控制上传按钮显示,我是放在了App.vue中
.notNeedShowAddUploadImg{
display: none!important;
}


注意:limitMin和limitMax两个同使用可以实现,最少上传2张,最多上传4张,实现区域限制,下面有效果演示
文件个数也可限制
在这里插入图片描述

Methods

MethodDescription
@deleteServeFile=“deleteServeFile”图片文件进行删除的时候会触发,此时你会拿到文件的信息,去服务器删除数据+
@setUrlPath=“SetUrlPath”文件上传到服务器,会通过这个自定义方发把服务返回内容传过去

对象参数

this.$emit('setUrlPath',{
        fromKey: this.fromKey,
        url: response.imgUrl, //传入服务器返回数据
        multiple, //判断是否是多选
        response,//服务器返回的信息
        nowIndex:
          multiple === true
            ? fileList.findIndex(item => item.url === response.imgUrl)
            : "" //传入当前下标
      })

注意

文件上传成功后会通过这个参数把把服务器返回的数据,返回过来,大家可以在这里进行数据处理
下面是我的使用方发,大家可以借鉴

    SetUrlPath(prcturlData) {
      if (prcturlData.multiple) {//判断单选多选
      //fromdata 点击保存按钮向服务器发送数据
        this.fromdata[prcturlData.fromKey[prcturlData.nowIndex]] =
          prcturlData.url;
      } else {//单选直接复制,URL是文件上传成功后,返回的地址
        this.fromdata[prcturlData.fromKey] = prcturlData.url;
      }
    },

建议element版本2.5以上哦,不然slot-scope不好使,你的单个删除按钮也没有用

在这里插入图片描述

部分内容效果演示

图片格式 + 是否校验 + 一键清空 +上传成功后不再显示上传按钮

在这里插入图片描述

:listType='picture-card'
默认是:picture-card(图片格式) 可选值 text(文件格式)

:needRequired='false'
默认是true,需要校验,设置为false就不会对大校验了,

:errorMessage='校验提示内容'
校验内容自定义

:showClearAllBtn='true'
是否显示一键清空按钮,默认是true

:putSuccessShowAddBtn='false'
上传成功后是否还继续显示上传按钮,默认是 false 不显示
图片格式 + 上传成功显示按钮 + 限制文件大小在这里插入图片描述
:Size="0.05"
默认是 false,想校验文件大小之接按1024计算传过去就好了

:putSuccessShowAddBtn='true'
上传成功后是否还继续显示上传按钮,默认是 false 不显示

:listType='picture-card'
默认是:picture-card(图片格式) 可选值 text(文件格式)
 
图片限制比例大小 (80*80)

在这里插入图片描述

  :Proportion="[250,250]"
  需要校验比例的话需要传入一个数组,且必须为两个值值类型为数字,多传无效
  
  :computationRule="'>='"
  校验的类型,=== 大小必须等于 >= 比例大小大于等于, 比例大小 <=
limitMin和limitMax实现区域限制

在这里插入图片描述

文件类型在这里插入图片描述

其他都一样,之不过这个是文件类型的

  :listType="'text'"
  默认是:picture-card(图片格式) 可选值 text(文件格式)

注意:实时监听校验的时候,你需要在setUrlPath这个方法里面在执行下面的代码一次

 this.$refs.你校验的表单.validate(valid => {})

结尾

暂时就写这么多吧,记得收藏哦😘

如果各位小哥有更好的建议或意见欢迎评论区提出,我会根据实际情况进行更改组件
Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐