README

hf-upload

Introduce

将本地文件直接上传到阿里云或七牛云，分片上传，支持大文件上传

Installation

npm install hf-uploader --save or yarn add hf-uploader

Example

import React, { useRef, useEffect } from 'react'
import ReactDom from 'react-dom'
import HFUpload from 'hf-upload'

function Example() {
  const uploader = useRef(null)
  const inputRef = useRef(null)

  // 确定不同文件类型上传的方式  如：视频采用七牛云上传，其他方式采用阿里云
  const options = { rule: { video: 'qiniu' } }

  useEffect(() => {
    uploader.current = createUploader({
      accessKeyId: 'your accessKeyId',
      accessKeySecret: 'your accessKeySecret',
      stsToken: 'your stsToken',
      bucket: 'your bucket',
      region: 'oss-cn-beijing'
      qiniuToken：'your qiniuToken'
    })
  }, [])

  function createUploader(accessInfo) {
    return new HFUpload({
      params: accessInfo,
      options,
      onChange: ({ fileList }) => {
        console.log(fileList)
      }
    })
  }

  function handleChange(e) {
    const postFiles = [...e.target.files]
    uploader.current.add(postFiles)
    e.target.value = null
  }

  function handleClick() {
    const canUpload = uploader.current
    const el = inputRef.current
    if (!el || !canUpload) {
      return
    }
    el.click()
  }

  return (
    <input
      accept=".PNG,.JPG,.MP4"
      type="file"
      ref={inputRef}
      multiple={true}
      onClick={handleClick}
      onChange={handleChange}
    />
  )
}

ReactDOM.render(<Example />, container)

Prop Types

Property	Type	Default	Description	required
options	object	DefaultOptions	Options	N
params	object		Params to create ali-OSS or qiniu	N (you can use updateParams as well)
files	array		Initial files	N
onStart	function		Upload start	N
beforeUpload	function		Pre-upload operation	N
afterUpload	function		Post-upload operation	N
onChange	function		Upload status and percent change	N
onSucceed	function		Single file upload succeeded	N
onFailed	function		Single file upload failed	N
needUpdateParams	function		Called when parameters need to be updated	N

DefaultOptions

Property	Type	Default	Description
concurrency	number	2	Maximum concurrency
partSize	number	500	Part size (kb)
timeout	number	60*1000	Overtime time (ms)
retryCountMax	number	3	Retry times out
errorText	string	网络故障请重试	Error message
rule	object	{}	Select upload target by file type. If not specified, upload to Ali by default. eg: {'video': 'qiniu'}
uploadPath	string	tmp	Upload to the specified directory. eg:{ uploadPath: 'tmp/dev' }
md5	boolean	true	Calc md5 value
renderKey	function	void	render custome key
acl	object	null	set ACL https://www.alibabacloud.com/help/zh/doc-detail/144047.htm?spm=a3c0i.23458820.2359477120.7.7bff6e9bls2pX6

Method

const uploader = new HfUpload({})

add(files:Array): add upload file

uploader.add(files)
abort(uid:string): pause files being uploaded

uploader.abort(uid)
reupload(uid:string): resume / continue upload

uploader.reupload(uid)
delete(uid:string): delete file

uploader.delete(uid)
clear(): clear all

uploader.clear()
updateParams(params:Params): update parameters

uploader.updateParams(params)

Contributing

Fork, then clone the project.
Cd hf-upload, then yarn or npm install.
Run the project in development mode：yarn start or npm start.
Make your changes.
Commit and PR.

Document

Ali-oss SDK document：https://help.aliyun.com/document_detail/64041.html?spm=a2c4g.11186623.6.1208.373e5966mqf1Mw

qiniu JavaScript SDK document :https://developer.qiniu.com/kodo/sdk/1283/javascript

Usage no npm install needed!