|
23 | 23 | ## 概述 |
24 | 24 |
|
25 | 25 | Qiniu-JavaScript-SDK (下文简称为 JS-SDK)适用于 :IE11、Edge、Chrome、Firefox、Safari 等浏览器,基于七牛云存储官方 API 构建,其中上传功能基于 H5 File API。开发者基于 JS-SDK 可以方便的从浏览器端上传文件至七牛云存储,并对上传成功后的图片进行丰富的数据处理操作。 |
26 | | -JS-SDK 兼容支持 H5 File API 的浏览器,在低版本浏览器下,需要额外的插件如 plupload,JS-SDK 提供了一些接口可以结合插件来进行上传工作,注意:(在低版本浏览器需要引入 [babel-polyfill](https://babeljs.cn/docs/usage/polyfill/) 来解决 sdk 里某些语法或者属性浏览器不能识别的问题)。 |
| 26 | +JS-SDK 兼容支持 H5 File API 的浏览器,在低版本浏览器下,需要额外的插件如 plupload,JS-SDK 提供了一些接口可以结合插件来进行上传工作,注意:(在低版本浏览器需要引入 [babel-polyfill](https://babeljs.cn/docs/usage/polyfill/) 来解决 SDK 里某些语法或者属性浏览器不能识别的问题)。 |
27 | 27 |
|
28 | 28 | Qiniu-JavaScript-SDK 为客户端 SDK,没有包含 `token` 生成实现,为了安全,`token` 建议通过网络从服务端获取,具体生成代码可以参考以下服务端 SDK 的文档。 |
29 | 29 |
|
@@ -114,7 +114,7 @@ Qiniu-JavaScript-SDK 的示例 [Demo](http://jssdk-v2.demo.qiniu.io) 中的服 |
114 | 114 |
|
115 | 115 | ## 使用 |
116 | 116 |
|
117 | | -`qiniu.upload` 返回一个 `observable` 对象用来控制上传行为,`observable` 对像通过 `subscribe` 方法可以被 `observer` 所订阅,订阅同时会开始触发上传,同时返回一个 `subscription` 对象,该对象有一个 `unsubscribe` 方法取消订阅,同时终止上传行为。对于不支持 sdk 的浏览器可以参考 demo1 中用插件处理和 form 直传的方式; 一般 form 提交常常会导致网页跳转,demo1 中 form 直传通过加入 iframe,并结合后端 sdk 上传来解决网页跳转问题,实现 form 无刷新上传。分片上传时,JS-SDK支持断点续传功能,会把已上传片的后端返回值ctx信息存储到本地,有效期为一天,超过一天后,当继续上传该文件时会清除掉本地存储信息重新上传。 |
| 117 | +`qiniu.upload` 返回一个 `observable` 对象用来控制上传行为,`observable` 对像通过 `subscribe` 方法可以被 `observer` 所订阅,订阅同时会开始触发上传,同时返回一个 `subscription` 对象,该对象有一个 `unsubscribe` 方法取消订阅,同时终止上传行为。对于不支持 SDK 的浏览器可以参考 demo1 中用插件处理和 form 直传的方式; 一般 form 提交常常会导致网页跳转,demo1 中 form 直传通过加入 iframe,并结合后端 SDK 上传来解决网页跳转问题,实现 form 无刷新上传。分片上传时,JS-SDK支持断点续传功能,会把已上传片的后端返回值ctx信息存储到本地,有效期为一天,超过一天后,当继续上传该文件时会清除掉本地存储信息重新上传。 |
118 | 118 |
|
119 | 119 | ### Example |
120 | 120 |
|
@@ -198,7 +198,7 @@ qiniu.compressImage(file, options).then(data => { |
198 | 198 | * `QiniuNetworkError` 继承自 `QiniuRequestError` |
199 | 199 | * reqId: 由于请求可能还未真正发出,所以可能无法收集到 `reqId`,该字段可能为 `''`。 |
200 | 200 |
|
201 | | - * complete: 接收上传完成后的后端返回信息,具体返回结构取决于后端sdk的配置,可参考 [上传策略](https://developer.qiniu.com/kodo/manual/1206/put-policy)。 |
| 201 | + * complete: 接收上传完成后的后端返回信息,具体返回结构取决于后端 SDK 的配置,可参考 [上传策略](https://developer.qiniu.com/kodo/manual/1206/put-policy)。 |
202 | 202 |
|
203 | 203 | * subscription: 为一个带有 `unsubscribe` 方法的类实例,通过调用 `subscription.unsubscribe()` 停止当前文件上传。 |
204 | 204 |
|
@@ -505,17 +505,7 @@ qiniu.compressImage(file, options).then(data => { |
505 | 505 |
|
506 | 506 | **2. 限制上传文件的类型:** |
507 | 507 |
|
508 | | -这里又分为两种方法: |
509 | | - |
510 | | -1. 通过在 `token` 中设定 `mimeLimit` 字段限定上传文件的类型,该设定是在后端 sdk 设置,请查看相应的 sdk 文档,示例 |
511 | | - |
512 | | - ```JavaScript |
513 | | -"image/\*": 表示只允许上传图片类型; |
514 | | -"image/jpeg;image/png": 表示只允许上传 jpg 和 png 类型的图片; |
515 | | -"!application/json;text/plain": 表示禁止上传 json 文本和纯文本。(注意最前面的感叹号) |
516 | | -``` |
517 | | - |
518 | | -2. 通过 `putExtra` 的 `mimeType` 参数直接在前端限定 |
| 508 | +通过在生成 `token` 时指定 [上传策略](https://developer.qiniu.com/kodo/1206/put-policy) 中的 `mimeLimit` 字段限定上传文件的类型,该功能由生成 `token` 的服务端 SDK 提供,请查看对应的服务端 SDK 文档。 |
519 | 509 |
|
520 | 510 | ### 贡献代码 |
521 | 511 |
|
|
0 commit comments