jQuery File Upload 技术文档

1. 安装指南

jQuery File Upload 插件可以通过 NPM 进行安装：

npm install blueimp-file-upload

安装完成后，您可以通过以下方式引入 jquery.fileupload.js 文件及其扩展：

<script src="node_modules/blueimp-file-upload/js/jquery.fileupload.js"></script>

2. 项目使用说明

在文件上传表单上初始化插件，可以使用以下代码：

$('#fileupload').fileupload();

3. 项目API使用文档

该插件提供了丰富的 API 供开发者使用。以下是一些主要的 API：

• option(key, [value]): 获取或设置插件选项。
• destroy(): 销毁插件实例，恢复原 HTML 元素。
• upload(): 开始上传队列中的所有文件。
• cancelUpload(fileId): 取消上传指定的文件。
• getFiles(): 获取当前队列中的所有文件。

更多 API 文档，请查阅官方 GitHub 仓库的 API 部分。

4. 项目安装方式

必要要求

• jQuery v1.7+
• jQuery UI widget factory v1.9+（内含）：基本文件上传插件需要，但非常轻量，不包含 jQuery UI 套件中的其他依赖。
• jQuery Iframe Transport 插件（内含）：对于不支持 XHR 文件上传的浏览器，此插件是必需的。

可选要求

• JavaScript 模板引擎 v3+：用于渲染已选择和已上传的文件。
• JavaScript Load Image 库 v2+：图像预览和调整大小功能需要。
• JavaScript Canvas to Blob 聚合填充 v3+：调整大小功能需要。
• blueimp Gallery v2+：用于显示上传的图片。
• Bootstrap v3+：用于演示设计。
• Glyphicons 图标集：Bootstrap 使用。

跨域要求

使用 Iframe Transport 插件进行跨域文件上传时，需要一个重定向回源服务器以获取上传结果。示例实现使用 result.html 作为静态重定向页。

浏览器支持

桌面浏览器

该插件定期测试最新版本的浏览器，并支持以下最低版本：

• Google Chrome
• Apple Safari 4.0+
• Mozilla Firefox 3.0+
• Opera 11.0+
• Microsoft Internet Explorer 6.0+

移动浏览器

该插件已经测试并支持以下移动浏览器：

• Apple Safari on iOS 6.0+
• Google Chrome on iOS 6.0+
• Google Chrome on Android 4.0+
• Default Browser on Android 2.3+
• Opera Mobile 12.0+

更多浏览器支持详情，请参考官方 GitHub 仓库的浏览器支持部分。

测试

项目包含以下三组测试：

1. 使用 ESLint 进行代码规范检查。
2. 使用 Mocha 进行单元测试。
3. 使用 blueimp/wdio 进行端到端测试。

运行测试的步骤如下：

1. 启动 Docker。
2. 安装开发依赖：

npm install

3. 运行测试：

npm test

支持

此项目目前正在积极维护，但没有官方的支持渠道。如果您有其他开发者可能帮助您解答的问题，请将问题发布到 Stack Overflow 并使用 blueimp jquery file upload 标签。

许可

本项目遵循 MIT 许可。