# dfws-react-upload

> 东方网升 react 版本上传组件

Latest version **1.0.6** (published 2026-05-26) · ISC license · 0 weekly downloads

## Install

```sh
npm install dfws-react-upload
pnpm add dfws-react-upload
yarn add dfws-react-upload
bun add dfws-react-upload
```

## Health

**Score 45/100 (D)** — status: active.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.6 |
| Published | 2026-05-26 |
| First published | 2019-08-06 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 30.4 KB |
| Known vulnerabilities | 0 (+23 in 1 direct dependencies) |
| Install scripts | no |
| Author | dfws |
| Maintainers | dfws.fed |
| Keywords | plupload, dfws, oss, dongfangwangsheng, react |

## Links

- npm: https://www.npmjs.com/package/dfws-react-upload
- Repository: https://gitee.com/DongFangWangShengKaiFa/dfws-fed-component
- npm.io page: https://npm.io/package/dfws-react-upload

## Dependencies (7)

- [axios](https://npm.io/package/axios.md) ^0.27.2
- [jsonp](https://npm.io/package/jsonp.md) ^0.2.1
- [react](https://npm.io/package/react.md) ^16.8.6
- [ali-oss](https://npm.io/package/ali-oss.md) ^6.23.0
- [plupload](https://npm.io/package/plupload.md) ^2.3.6
- [react-dom](https://npm.io/package/react-dom.md) ^16.8.6
- [dfws-crypto](https://npm.io/package/dfws-crypto.md) 1.0.3

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.6 (latest) — 2026-05-26
- 1.0.5 — 2026-01-06
- 1.0.4 — 2025-12-30
- 1.0.3 — 2025-12-16
- 1.0.2 — 2025-12-16
- 1.0.1 — 2025-12-15
- 1.0.0 — 2025-12-04
- 0.2.1 — 2022-08-03
- 0.2.0 — 2022-08-03
- 0.1.1 — 2020-10-30
- 0.1.0 — 2019-10-24
- 0.0.9 — 2019-08-21
- 0.0.7 — 2019-08-19
- 0.0.6 — 2019-08-12
- 0.0.5 — 2019-08-08
- … 4 more at https://npm.io/package/dfws-react-upload/versions

## README

# 东方网升 react 版本上传组件

## 发布

1. `更改package.json版本`
2. `yarn run build`
3. `npm publish` 注：镜像源需切换回NPM官方源

## 链接

- [更新日志](CHANGELOG.md)

## 示例

- `yarn`
- `yarn start`

## 使用之前

该组件依赖于react,jsonp,plupload，使用之前请配置react,jsonp,plupload。

## 何时使用

- 需要oss文件上传。

## API

```html
const UploadData = {
  browse_button: 'auto-upload',
  url: 'oss',
  format: 'jpg,png',
  maxSize: '4',
  success: this.success,
  multi_selection: true,
  drop_element: 'drop',
  error: function (err) {
    console.log(err)
  },
  tipsFun: function (err) {
    alert(err.msg)
  },
  progress: function (uploader, file) {
    console.log(uploader.files)
    console.log(file.percent)
  },
}
<Upload {...UploadData} >
  <div id="auto-upload">上传文件</div>
  <div id="drop">拖拽上传</div>
</Upload>
```

### upload props

| 参数 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| **uuid** | 上传资源业务对应uuuid | string | - |
| **ticket** | 用户ticket，调用request方法不需要传值 | string | - |
| **channel** | 来源渠道，调用request方法不需要传值 | obeject | - |
| **debug** | 是否打开调式模式 | boolean | false |
| **isEncoding** | 调用request方法时生效 | boolean | false |
| **onGetUpload** | 获取上传方法实例 | function | - |
| **request** | 基础请求基类 | function | - |
| browse_button | 触发文件选择对话框的DOM元素的id，当点击该元素后便后弹出文件选择对话框 | string or DOM | - |
| success | 上传成功后的回调函数 返回数组 [{file:文件信息,url:上传完成后的路径}] | function | - |
| error | 上传失败后的回调函数 返回数组[]err信息 | function | - |
| tipsFun | 选择文件不符合限制的回调函数 返回 {type:1,msg:'格式错误'} {type:2,msg:'大小错误'} | function | - |
| fileAdd | 选择文件后手动操作文件的回调函数 返回[] 选择的文件组 需要与isStart并用  | function | - |
| progress | 上传时的回调函数 返回uploader,file uploader为当前的plupload实例对象，file为触发此事件的文件对象 | function | - |
| multi_selection | 是否多选 | boolean | true |
| isStart | 是否选择完文件后自动上传 | boolean | true |
| maxSize | 文件最大限制 单位M | number | - |
| format | 可选的文件格式 以逗号分割 | string | - |
| container | 上传的容器 | string or DOM | - |
| drop_element | 指定了使用拖拽方式来选择上传文件时的拖拽区域的id | string or DOM | - |

### 返回值

uploader实例对象 start()启动上传 addUploadFile(file,uploader) 添加文件进入上传队列（操作文件后使用）  file：需要添加的文件 uploader：uploader实例对象

### 参考文档

[pluload](http://www.phpin.net/tools/plupload/)

---
_Source: https://npm.io/package/dfws-react-upload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._