上传列表 AcAttachment
何时使用
如何使用
npm install ac-attachment -S
import AcAttachment from 'ac-attachment';
import 'ac-attachment/dist/ac-attachment.css';
代码演示
API
参数
名称 | 类型 | 默认值 | 是否必填 | 描述 |
---|
recordId | string | | 是 | 单据相关的唯一标示,一般包含单据ID,如果有多个附件的时候由业务自己制定规则 |
groupname | string | | 是 | 分组名 |
permission | string | | 否 | Oss权限(read,private,full),read是可读=公有,private=私有,当这个参数不传的时候会默认private |
tenant | string | | 否 | 附件查询使用,租户id,不写会自动从系统获取 |
url | string | | 否 | 里传true或false。为true,则返回附件的连接地址存到数据库中;如果isencrypt设置为true,url不能设置为true否则不能上传,提示:对于加密文件不能返回url,返回了也无法访问 |
isencrypt | boolean | false | 否 | 是否加密,默认false不加密 |
baseUrl | string | | 否 | 应用平台的地址(IP地址或域名) |
uploadUrl | string | /iuap-saas-filesystem-service/file/upload | 否 | 应用平台上传附件的地址 |
queryUrl | string | /iuap-saas-filesystem-service/file/query | 否 | 应用平台查询附件的地址 |
deleteUrl | string | /iuap-saas-filesystem-service/file/delete | 否 | 应用平台删除单个附件的地址 |
downloadUrl | string | /iuap-saas-filesystem-service/file/download | 否 | 应用平台下载附件的地址 |
batchDeleteUrl | string | /iuap-saas-filesystem-service/file/batchDeleteByIds | 否 | 应用平台批量删除附件地址 |
fileType | string | | 否 | 允许上传的文件类型, 使用MIME类型限制文件类型。例如:txt文档类型为text/plain, png图片类型为image/png。可以使用*通配符,image/*代表所有图片类型。多个文件类型使用逗号隔开,例如:'image/*, text/plain'。详见 File Type, MIME类型 |
fileMaxSize | number | 10 | 否 | 单个上传文件的大小上限,默认是10M,单位是M |
fileNum | number | 999 | 否 | 上传文件的总数量限制 |
multiple | boolean | true | 否 | 是否支持一次多个文件上传,在文件选择框中,按shift或ctrl键,同时选择多个文件,点击确定即可 |
disabled | boolean | false | 否 | 上传,下载,删除按钮是否禁用 |
className | string | | 否 | 附件容器的自定义class |
checkDuplicate | boolean | true | 否 | 文件上传是否检测文件名重复 |
locale | string | zh | 否 | 组件语言类型,默认是简体中文,目前支持英文(en或en_US),简体中文(zh_CN),繁体中文(zh_TW) |
事件
名称 | 类型 | 描述 |
---|
onFileTypeOver | file ,当前上传的文件对象 | 文件类型超出限制回调 |
onFileSizeOver | file ,当前上传的文件对象 | 文件大小超出限制回调 |
onFileNumOver | file ,当前上传的文件对象 | 文件数量超出限制回调 |
onDelete | attach | 参数attach为附件组件实例,调用attach.fDelete(),可以调起接口删除附件 |
onUploadSuccess | data ,上传成功返回值 | 上传成功回调 |
onUploadError | data ,上传出错返回值 | 上传出错回调 |
onUploadDelete | data ,上传删除返回值 | 上传删除回调 |
onDeleteFile | data ,删除文件返回值 | 删除文件回调 |
注意事项
文件列表刷新
组件在recordId发生变化,会自动刷新文件列表,也可以手动刷新文件列表,用法如下:
<AcAttachment ref={(c) => {this.attach = c.attach}} recordId='' groupname='' />
this.attach.fLoadFileList();
自定义弹框删除文件
<AcAttachment ref={(c) => {this.attach = c.attach}} recordId='' groupname='' />
this.attach.fDelete();
<AcAttachment recordId='' groupname=''
onDelete={(attach) => {
if(confirm('确定删除记录吗?')){
attach.fDelete();
}
}}
/>
更新日志