Bootstrap input-file

Bootstrap input-file是一个极好的图片操作插件。

一、demo

二、插件引入

<link type="text/css" rel="stylesheet" href="${ctx}/components/fileinput/css/fileinput.css" />
<script type="text/javascript" src="${ctx}/components/fileinput/js/fileinput.js"></script>
<script type="text/javascript" src="${ctx}/components/fileinput/js/fileinput_locale_zh.js"></script>

http://plugins.krajee.com/file-input,这是其官方文档，里面有下载地址。

三、页面

<input type="file" name="image" class="file" value="${deal.image}"/>

1. type=file和class=file，指明其为input file类型。
2. name指定其在后台的获取key。
3. value指定其在展示的时候图片路径。

四、页面加载时执行

$(‘input[type=file]‘).each(function() {
        var imageurl = $(this).attr("value");
        if (imageurl) {
            $(this).fileinput({
                showUpload : false,
                language : ‘zh‘,
                allowedFileTypes : [ ‘image‘ ],
                allowedFileExtensions : [ ‘jpg‘, ‘png‘, ‘gif‘ ],
                maxFileSize : 2000,
                initialPreview : [ // 预览图片的设置
                "<img src=‘" + imageurl + "‘ class=‘file-preview-image‘>", ],
            });
        } else {
            $(this).fileinput({
                showUpload : false,
                language : ‘zh‘,
                allowedFileTypes : [ ‘image‘ ],
                allowedFileExtensions : [ ‘jpg‘, ‘png‘, ‘gif‘ ],
                maxFileSize : 2000,
            });
        }

    });

1. 通过jquery获取对应的input file，然后执行fileinput方法。
2. showUpload 设置是否有上传按钮。
3. language指定汉化
4. allowedFileTypes 、allowedFileExtensions 不知道为什么没有起到效果？
5. maxFileSize 指定上传文件大小

五、jfinal端

        // 获取file，进行保存
        UploadFile file = getFile("image");

笑对现实的无奈，不能后退的时候，不再傍徨的时候，永远向前　路一直都在──陈奕迅《路一直都在》
本文出自:【沉默王二的博客】

ps：以上博客留了一个小疑问，一直没有去研究，直到有位非常棒的小伙伴给了我如下的提醒：

ihchenchen昨天 13:42发表 [回复] allowedFileTypes 、allowedFileExtensions 我知道为什么没有效果，因为fileinput()方法调用了两次，一次在fileinput.js里面最后几行，还有一次就是你自己写的$(this).fileinput()。在fileinput.js里的是没有设置allowedFileTypes 、allowedFileExtensions 值的。 有两种方法可以改：1、把fileinput.js里的最后几行调用注释掉。2、全部使用“data-”的方法来做，不写$(this).fileinput()。

对于ihchenchen善意的提醒，我非常的感谢，虽然他提供的解释并没有解决我的疑问，但是我很喜欢这样有互动的技术交流，之前写很多博客，基本上很少发生这样善意并且行之有效的回答。这让我想起中国程序员和外国程序员，里面的故事让人震撼之余，捎带着些许的惭愧。那么如何做到“Ask questions, get answers, no distractions。”就显得特别珍贵，而“ihchenchen”则充满这种精神！

六、解惑allowedFileTypes 、allowedFileExtensions

之前困惑为什么bootstrap fileinput为什么设置了这两个属性后，没有效果，其实是我自己的误解，如今经过一番痛彻的领悟后恍然大悟！

①、allowedFileTypes

allowedFileTypes
array the list of allowed file types for upload. This by default is set to null which means the plugin supports all file types for upload. If an invalid file type is found, then a validation error message as set in msgInvalidFileType will be raised. The following types as set in fileTypeSettings are available for setup.

[‘image’, ‘html’, ‘text’, ‘video’, ‘audio’, ‘flash’, ‘object’]

先从“allowedFileTypes”说起，该属性告知我们文件的选择类型，那么我们很容易想到这样的画面：

也就是说，我们希望此时的“所有文件”处不是“所有文件”，而是“image”之类的。显然这样的逻辑并没有错，但却不适合bootstrap fileinput！

那么，这个时候我就很容易认为“allowedFileTypes” 没有起到作用！

但请看下图：

吼吼，原来是在你选择了文件后发生的类型检查！

②、allowedFileTypes工作原理

            $(this).fileinput({
                showUpload : false,
                showRemove : false,
                language : ‘zh‘,
                allowedPreviewTypes: [‘image‘],
                allowedFileTypes: [‘image‘],
                allowedFileExtensions:  [‘jpg‘, ‘png‘],
                maxFileSize : 2000,

            });

通过fileinput方法我们加载一个bootstrap fileinput组件，那么其内部是如何实现allowedFileTypes的呢？

通过在fileinput.js文件中搜索“allowedFileTypes”关键字，我们得到如下代码：

 var node = ctr + i, previewId = previewInitId + "-" + node, isText, file = files[i],
                    caption = self.slug(file.name), fileSize = (file.size || 0) / 1000, checkFile, fileExtExpr = ‘‘,
                    previewData = objUrl.createObjectURL(file), fileCount = 0, j, msg, typ, chk,
                    fileTypes = self.allowedFileTypes, strTypes = isEmpty(fileTypes) ? ‘‘ : fileTypes.join(‘, ‘),
                    fileExt = self.allowedFileExtensions, strExt = isEmpty(fileExt) ? ‘‘ : fileExt.join(‘, ‘);

然后我们继续看到如下的代码：

 if (!isEmpty(fileTypes) && isArray(fileTypes)) {
                    for (j = 0; j < fileTypes.length; j += 1) {
                        typ = fileTypes[j];
                        checkFile = settings[typ];
                        chk = (checkFile !== undefined && checkFile(file.type, caption));
                        fileCount += isEmpty(chk) ? 0 : chk.length;
                    }
                    if (fileCount === 0) {
                        msg = self.msgInvalidFileType.replace(‘{name}‘, caption).replace(‘{types}‘, strTypes);
                        self.isError = throwError(msg, file, previewId, i);
                        return;
                    }
                }

我们可以发现，文件类型的检查是发生在checkFile方法上，那么checkFile方法到底做了些什么呢？

 defaultFileTypeSettings = {
        image: function (vType, vName) {
            return (vType !== undefined) ? vType.match(‘image.*‘) : vName.match(/\.(png|jpe?g)$/i);
        },
        ...

以上就是checkFile的内容。

1. 也就是说当我们指定allowedFileTypes: [‘image‘],时，就会进行image的类型检查。
2. 显然我们选择的txt文件不属于image类型，那么就会匹配不上，出现以上界面。
3. 同时，该方法告诉我们，当不指定allowedFileTypes: [‘image‘],，只指定allowedFileExtensions: [‘jpg‘, ‘png‘],就会执行vName.match(/\.(png|jpe?g)$/i)，也就是文件后缀类型的检查，这点很关键啊，为我们接下来介绍“allowedFileExtensions”奠定基础。

③、allowedFileExtensions什么时候起作用

上节我们讨论完“allowedFileTypes”，捎带说了“allowedFileExtensions”，那么如何让后缀进行check呢？

            $(this).fileinput({
                showUpload : false,
                showRemove : false,
                language : ‘zh‘,
                allowedPreviewTypes: [‘image‘],
                allowedFileExtensions:  [‘jpg‘, ‘png‘],
                maxFileSize : 2000,

            });

fileinput组件此时指定的属性如上，没有了“allowedFileTypes”，并且指定允许的后缀类型为“[‘jpg’, ‘png’]”，也就是说，假如我们选择了gif的图片就会出现错误提示。

错误预期的发生了，那么请特别注意：

image: function (vType, vName) {
            return (vType !== undefined) ? vType.match(‘image.*‘) : vName.match(/\.(png|jpe?g)$/i);
        },

fileinput.js文件中原始的代码如下：

 image: function (vType, vName) {
            return (vType !== undefined) ? vType.match(‘image.*‘) : vName.match(/\.(gif|png|jpe?g)$/i);
        },

image类型的后缀当然默认包含了gif，我只是为了举例说明，代码做了调整，请注意！

巴拉巴拉说了这么多，还有一点想说的是：遇到问题时，先不要怀疑源码，首先怀疑的是你自己！