README

演示

演示文件上传

描述

支持多文件选择、拖放上传、进度条、验证和预览图片、音频和视频的jQuery文件上传小部件。
支持跨域、分块和可恢复文件上传，以及客户端图像调整大小。与任何支持标准HTML表单文件上传的服务器端平台（PHP、Python、Ruby on Rails、Java、Node.js、Go等）兼容。

设置

• 如何在您的网站上设置此插件
• 如何仅使用基本插件（最小化设置指南）。

支持

• 支持论坛
  支持请求和关于文件上传插件的通用讨论可以发布到官方的支持论坛。
  如果您的提问与文件上传插件没有直接关系，您可能通过在Stack Overflow上发布来获得回复的机会。

• 错误和功能请求
  可以通过问题跟踪器报告错误和功能请求。
  在发布之前，请阅读问题指南。

功能

• 多文件上传
  允许一次性选择多个文件并同时上传。
• 拖放支持
  允许通过从桌面或文件管理器拖放文件到浏览器窗口来上传文件。
• 上传进度条
  显示进度条，指示单个文件和所有上传的综合上传进度。
• 可取消上传
  可以取消单个文件上传以停止上传进度。
• 可恢复上传
  使用支持Blob API的浏览器可以恢复已中断的上传。
• 分块上传
  使用支持Blob API的浏览器可以将大文件分块上传。
• 客户端图像调整大小
  使用支持所需JS API的浏览器，可以自动在客户端调整图像大小。
• 预览图片、音频和视频
  使用支持所需API的浏览器，可以在上传前显示图片、音频和视频文件的预览。
• 无需浏览器插件（例如Adobe Flash）
  实现基于HTML5和JavaScript等开放标准，无需额外的浏览器插件。
• 对旧浏览器的优雅降级
  如果支持，则通过XMLHttpRequests上传文件，并使用iframe作为旧浏览器的降级方案。
• HTML文件上传表单降级
  允许使用标准HTML文件上传表单作为小部件元素进行渐进式增强。
• 跨站文件上传
  支持使用跨站XMLHttpRequests或iframe重定向将文件上传到不同的域。
• 多个插件实例
  允许在同一网页上使用多个插件实例。
• 可自定义和可扩展
  提供API以设置单个选项和定义各种上传事件的回调方法。
• 多部分和文件内容流上传
  文件可以以标准的“multipart/form-data”或文件内容流（HTTP PUT文件上传）的形式上传。
• 与任何服务器端应用平台兼容
  适用于任何支持标准HTML表单文件上传的服务器端平台（PHP、Python、Ruby on Rails、Java、Node.js、Go等）。

要求

强制要求

• jQuery v. 1.6+
• jQuery UI widget factory v. 1.9+（包含在内）
• jQuery Iframe Transport插件（包含在内）

jQuery UI widget factory是基本文件上传插件的必要条件，但它非常轻量级，不依赖于jQuery UI套件中的任何其他依赖项。

jQuery Iframe Transport对于不支持XHR文件上传的浏览器是必需的。

可选要求

• JavaScript模板引擎 v. 2.3.1+
• JavaScript Load Image库 v. 1.9.1+
• JavaScript Canvas to Blob polyfill v. 2.0.7+
• blueimp Gallery v. 2.7.3+
• Bootstrap CSS框架 v. 3.0.0+
• 图标

JavaScript模板引擎用于渲染Basic Plus UI和jQuery UI版本的已选和上传文件。

JavaScript Load Image库和JavaScript Canvas to Blob polyfill是图像预览和调整大小功能的必要条件。

blueimp Gallery用于在相框中显示上传的图像。

除了jQuery UI版本之外的所有版本的用户界面都是使用Twitter的Bootstrap框架和Font Awesome图标构建的。

跨域要求

使用跨域文件上传的Iframe Transport插件需要将重定向回源服务器以检索上传结果。示例实现使用result.html作为源服务器的静态重定向页面。

仓库还包括jQuery XDomainRequest Transport插件，它可以在Microsoft Internet Explorer 8和9（IE 10支持跨域XHR请求）中启用有限的跨域AJAX请求。
XDomainRequest对象仅允许GET和POST请求，并且不支持文件上传。它在示例中用于从跨域演示文件上传服务中删除上传的文件。

浏览器

桌面浏览器

文件上传插件定期与最新浏览器版本进行测试，并支持以下最低版本

• 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+
• Android 2.3+上的默认浏览器
• Opera 移动版 12.0+

支持的功能

有关每个浏览器版本支持功能的详细概述，请参阅扩展浏览器支持信息。

许可证

在MIT 许可证下发布。

捐赠

jQuery File Upload 是免费软件，但您可以捐赠以支持开发者 Sebastian Tschan。

Flattr:

PayPal: