expose downloadAsFile; add api options in uploading; alpha release

Author: ChenYong

README.md

@@ -20,6 +20,7 @@ configureUploading({ apiHost: "https://demo-host.com", locales: {} });
 uploadByUrl;
 getDownloadUrl;
 getUploadUrl;
+downloadAsFile;
 ```
 
 当前模块提供了四个组件:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jimengio/files-picker",
-  "version": "0.0.1-a11",
+  "version": "0.0.1-a12",
   "description": "",
   "main": "lib/index.js",
   "scripts": {

src/api.tsx

@@ -1,4 +1,4 @@
-import { get, put, post } from "@jimengio/api-base";
+import { get, put, post, IJimuApiOption } from "@jimengio/api-base";
 import { IUpload, IDownload } from "./model";
 
 import { apiHost } from "./config";
@@ -13,13 +13,14 @@ export const uploadSign = async (url: string, fileName: string) => {
   });
 };
 
-export const uploadByUrl = async (fileUrl: string, file: File) => {
+export const uploadByUrl = async (fileUrl: string, file: File, options?: IJimuApiOption) => {
   return put<void>({
     url: fileUrl,
     data: file,
     headers: {
       "Content-Type": mime.contentType(file.type),
     },
+    ...options,
   });
 };
 

src/component/base-display.tsx

@@ -4,7 +4,7 @@ import { css } from "emotion";
 import { Icon } from "antd";
 import { Space } from "@jimengio/flex-styles";
 import { useDownloadApi } from "../hooks";
-import { download } from "../util";
+import { downloadAsFile } from "../util";
 
 interface IProps {
   url: string;
@@ -34,7 +34,7 @@ let BaseDisplay: FC<IProps> = React.memo((props) => {
                 className={style.mouse}
                 onClick={async () => {
                   const downloadUrl = await downloadingResource.startDownload(props.url, path);
-                  download(downloadUrl);
+                  downloadAsFile(downloadUrl);
                 }}
               />
               {readOnly ? null : (

src/component/dropzone.tsx

@@ -9,7 +9,7 @@ import JimoIcon, { EJimoIcon } from "@jimengio/jimo-icons";
 import { interpolateLocale } from "../util";
 import { uploadingLocales } from "../config";
 import { useUploadApi, useDownloadApi } from "../hooks";
-import { download } from "../util";
+import { downloadAsFile } from "../util";
 
 interface IProps {
   className?: string;
@@ -139,7 +139,7 @@ let Dropzone: FC<IProps> = React.memo((props) => {
   let reqDownload = async (path: string) => {
     try {
       const downloadUrl = await downloadingResource.startDownload(props.downloadUrl, path);
-      download(downloadUrl);
+      downloadAsFile(downloadUrl);
     } catch (error) {
       console.error(error);
       message.error(uploadingLocales.downloadFailure);

src/index.ts

@@ -6,3 +6,5 @@ export { default as Dropzone } from "./component/dropzone";
 export { uploadByUrl, getDownloadUrl, uploadSign } from "./api";
 export { useDownloadApi, useUploadApi } from "./hooks";
 export { processImageUrl } from "./util/image";
+
+export { downloadAsFile } from "./util";

src/util.tsx

@@ -1,4 +1,8 @@
-export const download = (url: string, fileName?: string) => {
+/**
+ * Use this paired with Content-Disposition
+ * https://stackoverflow.com/a/9195376/883571
+ */
+export const downloadAsFile = (url: string, fileName?: string) => {
   const a = document.createElement("a");
   a.href = url;
   a.setAttribute("download", "true");
@@ -19,7 +23,7 @@ export const getAttachmentName = (attach: string): string => {
 
 export const downloadByBlob = (data: Blob, fileName?: string) => {
   const url = URL.createObjectURL(data);
-  download(url, fileName);
+  downloadAsFile(url, fileName);
 };
 
 export function interpolateLocale(template: string, data: { [k: string]: any }) {