"Uploadify3.1参考手册详细解读"
Uploadify是一个基于jQuery的文件上传插件,它提供了丰富的配置选项、事件和方法,使得文件上传功能更加灵活和易用。在Uploadify3.1版本中,我们可以看到以下关键知识点:
1. **配置项**:
- `auto`:默认值为`true`,表示在用户选择文件后是否自动开始上传。如果设置为`false`,则需要手动触发上传。
- `buttonClass`:允许添加额外的CSS类到上传按钮,以自定义其样式。
- `buttonCursor`:设置上传按钮鼠标悬停时的光标形状,默认为`'hand'`,即手型。
- `buttonImage`:指定按钮的背景图片URL,若不设置,则无背景图片。
- `buttonText`:设置按钮上显示的文字,如不设置,默认为`'SELECT FILES'`。
- `checkExisting`:若设置为一个路径,Uploadify会检查服务器上是否存在相同的文件,防止重复上传。
- `debug`:启用或禁用调试模式,`false`表示关闭,`true`表示开启。
- `fileObjName`:定义服务器端接收文件时的字段名,例如在PHP中通过`$_FILES['myFile']`来访问。
- `fileSizeLimit`:定义单个文件的最大大小,如`'100KB'`表示限制在100KB内。
- `fileTypeDesc`:对可选文件类型的描述,用于提示用户。
- `fileTypeExts`:指定允许的文件扩展名,如` '*.gif;*.jpg;*.png'`仅允许上传GIF、JPG和PNG图像。
- `formData`:附加上传的数据,可以在服务器端通过`$_POST`或`$_GET`获取。
- `height`:设定上传按钮的高度,默认为30像素。
- `method`:默认使用`'post'`方法上传文件,也可设置为`'get'`。
- `multi`:默认为`true`,支持多文件上传。若设置为`false`,则只能选择一个文件。
- `overrideEvents`:允许覆盖插件内置的某些事件处理。
2. **事件**:
Uploadify提供了多种事件,允许开发者在特定的阶段介入并执行自定义操作。例如:
- `onSelect`: 文件被选择时触发。
- `onQueueFull`: 队列满时触发。
- `onOpen`: 上传请求开始时触发。
- `onProgress`: 文件上传过程中触发,提供进度信息。
- `onComplete`: 单个文件上传完成后触发。
- `onError`: 上传错误时触发。
- `onClearQueue`: 清除队列时触发。
- `onCancel`: 用户取消上传时触发。
- `onDestroy`: Uploadify实例销毁时触发。
3. **方法**:
- `stop()`: 停止所有上传。
- `queue.clear()`: 清空上传队列。
- `queue.addItem()`: 添加新的文件到队列。
- `queue.removeItem()`: 移除队列中的某个文件。
- `settings()`: 获取或设置当前的配置项。
- `upload()`: 开始上传文件。
通过这些配置选项、事件和方法,开发者可以创建符合特定需求的文件上传界面,实现如限制文件类型、大小,显示上传进度,以及与服务器端进行复杂交互等功能。理解并熟练运用Uploadify3.1的特性,能够极大地提升用户体验和开发效率。