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配置失效。