bootstrap file input 官方文档翻译

file Input官方文档 中文翻译

file input 特性

1、这个插件会把简单的html文件变成一个更好用的文件选择输入控件，通过一个html的文件输入框，能兼容那些不支持jquery或js的浏览器。

2、fileinput 插件包括options，templates等三个部分来控制展示

　　。文件标题部分：用来展示选中的文件的简介信息

　　。文件按钮行为部分：用来浏览，移除和上传文件

　　。文件预览部分：用来将展示选中的文件到客户端实现预览（支持图片, 文档, flash, 和视频类型），别的文件类型将以宿略图的形式预览

3、如果你设置了class=file，这个插件就会自动把type为file的input框转换成一个文件选择输入框，input框的所有选项可以通过html5的data属性来实现。

4、能够选择和预览多个文件，使用html5 文件阅读api来读取和预览文件。如果很多文件被选到了，会展示文件正在被加载到预览区的过程。

5、提供可以根据你对fileinput不同的展示需求，而改变的预定义tmplate和css 类。

6、能够配置这个插件来初始化带有标题的预览图（对更新记录的场景最有用）。插件选项部分的initialPreview,initialPreviewConfig,和initialCaption这三个属性来配置这个功能。

7、能够把内容凸显出来作为一个预览，可以看到幻灯片缩放预览效果和最大限度放大或者全屏预览。

8、通过拖拽来排序/重新安排初始化的预览内容。

9、能够完全控制摆放组件，可以控制样式和布局。

10、通过 locales/translations.来支持在相同的页面使用多种语言组件。

11、显示或者隐藏一些或者全部的以下选项：

　　。标题部分

　　。预览部分

　　。上传部分

　　。移除部分

12、定制目标容器元素的展示位置来显示 标题容器，标题文字，预览容器，预览图片，预览状态插件。

13、对于text文件预览，会自动用缩略图来包裹，当触发onhover事件时会将一个用于完全展示内容指示链接展示出来。

14、定制预览，加载过程，和文件选择的信息。

15、上传路径默认指向form的submit事件，支持ajax上传传递参数。

16、开发了更先进的jquery触发事件。目前能使用的事件有，filereset, fileclear, filecleared, fileloaded, 和 fileerror。

17、支持readonly和disabled属性。

18、对超过它的容器宽度的文件标题，动态的分配大小。

19、增强fileimageuploaded 事件，使图片完全加载到预览区之后还能被移除。

20、当图片大小超过预览区的宽度时，自动调整预览图片大小。

21、完全模块化，具有可扩展型，允许开发者根据自己需求来配置file-input插件。

22、根据不同的预览类型智能预览，内置文件类型分类有：image, text, html, video, audio, flash,object, 和其他.

23、allowedPreviewTypes：你可以配置所有被允许展示在预览区的文件类型，这些默认是['image', 'html', 'text', 'video', 'audio', 'flash', 'object']，因此所有的文件类型被看成一个对象。例如：只展示image和video，你可以这样设置['image', 'video']。要想使内容预览变得不可用只显示预览icon而不是缩略图，你可以把这个属性设置为null，空值，或者false。

24、allowedPreviewMimeTypes：除了allowedPreviewTypes，你还可以控制所有的mime类型（ajax中的contenttype）是否展示预览，这个默认值是null，意味着所有的mime类型会被展示出来，>注意：使用2.5.0 版本的，你可以通过设置allowedFileTypes 和 allowedFileExtensions来控制哪种文件类型或文件扩展可以被展示。

25、layoutTemplates：允许你通过一个属性配置所有的布局模板。布局对象可以配置为：main1, main2,preview, caption, 和 modal

26、previewTemplates：所有的为每种类型配置的模板都被整合到一个属性里，而不是把image，text等分开配置模板。key值是设置在allowedPreviewTypes 的各种格式，value是用于预览的模板。对于每个预览文件类型（generic, image, text, html, video, audio, flash, object, 和 other）都有默认的预编辑模板，通用模板使用指令标志仅用于显示initialPreview 内容。

27、previewSettings：允许你给每个预览图片类型配置宽度和高度，这个插件为每个文件类型（image, text, html, video, audio, flash, 和 object）设置了预定义的高度和宽度。

28、fileTypeSettings：允许你给每个预览图片类型调用一个回调方法来配置和改变它，这个插件有默认的回调方法来识别每种文件类型（image, text, html, video, audio, flash, 和 object）。

29、增强使用模板代替标签的功能，使用这个版本，将会代替模板string来自动检查标签的多个事件。

30、通过返回输出来控制事件，在任何事件里增加自定义校验来阻止上传。

31、翻译和区域设置的支持

注意：flash预览功能需要安装Shockwave flash插件并且被客户端浏览器支持。flash预览功能目前只能成功在webkit 内核的浏览器中工作。video或者audio格式的被支持html5的现代浏览器支持。要注意浏览器有对video、audio格式（mp4,webm,ogg,mp3,wav）的标签数量进行限制。video文件的大小推荐使用小的，（可以通过maxFileSize属性来控制），以至于不影响预览效果。

File Upload 特点