ac-attachment
v0.3.8
Published
``` npm install ac-attachment -S
Downloads
149
Readme
上传列表 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();
}
}}
/>