@shihuo/upload-component

基于fusion Upload组件,实现统一的上传配置入口

Usage no npm install needed!

<script type="module">
  import shihuoUploadComponent from 'https://cdn.skypack.dev/@shihuo/upload-component';
</script>

README

统一上传组件

@shihuo/upload-component

基于 fusion Upload 组件,实现统一的上传配置入口,支持所有用法,特殊用法和说明你请看下方 API 和实际使用用例

@alifd/next 版本: ^1.19.8

API

参数名 说明 必填 类型 默认值 备注
validate 校验模式 boolean false 开启后自定校验字段生效。
默认情况下用法等同fusion的Upload组件
preventMessage 阻止内置提示框弹出 boolean false
volume 文件大小限制 number 2 文件大小最大限制,可输入浮点数
单位:M
ratio 宽高比 string/number/Array 1:1 预设 1:1、3:4选项
支持传入字符串格式 "数字:数字"
如:10:7 表示宽/高必须10/7
支持传入数字:值表示宽/高
支持传入数组:其中一种宽高比通过即校验通过
widthRange 宽度范围 number/string/Array [600, 2500] null表示不限宽
number以及字符串数字表示固定宽度
heightRange 高度范围 number/string/Array [600, 2500] 同withRange
beforeUploadVolumeError function beforeUpload阶段【文件大小】校验不通过触发
反参:
{errorMessage}, file, reader, options
beforeUploadRatioError function beforeUpload阶段【比例】校验不通过触发
反参:
{errorMessage}, file, reader, options
beforeUploadSizeError function beforeUpload阶段【尺寸】校验不通过触发
反参:
{errorMessage}, file, reader, options
onValidateError 整体校验错误回调 function: () => object 反参:
{
volume: boolean 【false大小校验不通过】
volumeError: 错误信息
ratio: boolean【false宽高比校验不通过】
ratioError
size: boolean 【false尺寸校验不通过】
sizeError
}
file:文件对象
reader:FileReader
options:beforeUpload透传的options
blockCheck 阻断校验 boolean false 设置true情况:校验不通过时立即停止继续执行。
执行对应beforeUpload错误回调函
数。并执行onValidateError回调

注意:组件内部预定义了上传配置,覆盖action后内置上传配置失效,同时内置formatter配置失效。