bootstrap 为 flask 使用人员提供了一个非常优美且有效的前端页面组件,但是完美之处还存在些许缺陷,比如文件的上传功能.而 bootstrap-fileinput 是基于 bootstrap 的控件,非常完美的填补了这个空缺.

注意: 本文是基于 bootstrap-fileinput v4.4.2. github 地址: https://github.com/kartik-v/bootstrap-fileinput

注意: 本文是主要是以 http://plugins.krajee.com/file-input/demo 示例为基础进行讲解.

特别提醒

1. 使用文件夹选择文件上传, 需要用到 webkitdirectory. 该属性需要像 chrome 和 IE Edge 这样的浏览器才能支持. 并且必须使用一个按钮来选择文件夹, 不能使用拖拽功能.
2. 由于这两个示例主要是为了体现前端的 UI 设计, 视图函数的功能和前几章节没有二至, 因此不在特殊强调.

创建蓝图 Folder

创建方法请参照 flask 项目中使用 bootstrapFileInput(构建篇) 中 lib 蓝图的创建方法,此处不在赘述.

构建基础 html 模板

app/folder/templates/advanced_common/base.html 的内容同前两章相同. 不在赘述.

文件夹上传示例 1

模板内容

app/folder/templates/ex_1.html 内容如下:

{% extends 'folder_common/base.html' %}
{% block content %}
<h1>文件夹上传示例1</h1>
<label class="control-label">Upload File From Folder</label>
<input id="input-folder-1" type="file" class="file-loading" webkitdirectory>
<script>
$(document).on('ready', function() {
    $("#input-folder-1").fileinput({
        browseLabel: '选择文件夹...'
    });
});
</script>
<hr>
<p>
    设置选择文件夹功能, 但只支持选择文件夹内的单一文件.
</p>
{% endblock %}
{% block title %}
    文件夹上传示例1
{% endblock %}

知识点

1. input 元素中添加 webkitdirectory 属性, 以便支持文件夹的选择方式.
2. browseLabel: ‘选择文件夹…’ 设置选择按钮的名称.

文件夹上传示例 2

模板内容

app/folder/templates/ex_2.html 内容如下:

{% extends 'folder_common/base.html' %}
{% block content %}
<h1>文件夹上传示例2</h1>
<label class="control-label">Upload All Files From Folder</label>
<input id="input-folder-2" name="input-folder-2[]" class="file-loading" type="file" multiple webkitdirectory accept="image/*">
<div id="errorBlock" class="help-block"></div>
<script>
$(document).on('ready', function() {
    $("#input-folder-2").fileinput({
        browseLabel: 'Select Folder...',
        previewFileIcon: '<i class="fa fa-file"></i>',
        allowedPreviewTypes: null, // set to empty, null or false to disable preview for all types
        previewFileIconSettings: {
            'doc': '<i class="fa fa-file-word-o text-primary"></i>',
            'xls': '<i class="fa fa-file-excel-o text-success"></i>',
            'ppt': '<i class="fa fa-file-powerpoint-o text-danger"></i>',
            'jpg': '<i class="fa fa-file-photo-o text-warning"></i>',
            'pdf': '<i class="fa fa-file-pdf-o text-danger"></i>',
            'zip': '<i class="fa fa-file-archive-o text-muted"></i>',
            'htm': '<i class="fa fa-file-code-o text-info"></i>',
            'txt': '<i class="fa fa-file-text-o text-info"></i>',
            'mov': '<i class="fa fa-file-movie-o text-warning"></i>',
            'mp3': '<i class="fa fa-file-audio-o text-warning"></i>',
        },
        previewFileExtSettings: {
            'doc': function(ext) {
                return ext.match(/(doc|docx)$/i);
            },
            'xls': function(ext) {
                return ext.match(/(xls|xlsx)$/i);
            },
            'ppt': function(ext) {
                return ext.match(/(ppt|pptx)$/i);
            },
            'jpg': function(ext) {
                return ext.match(/(jp?g|png|gif|bmp)$/i);
            },
            'zip': function(ext) {
                return ext.match(/(zip|rar|tar|gzip|gz|7z)$/i);
            },
            'htm': function(ext) {
                return ext.match(/(php|js|css|htm|html)$/i);
            },
            'txt': function(ext) {
                return ext.match(/(txt|ini|md)$/i);
            },
            'mov': function(ext) {
                return ext.match(/(avi|mpg|mkv|mov|mp4|3gp|webm|wmv)$/i);
            },
            'mp3': function(ext) {
                return ext.match(/(mp3|wav)$/i);
            },
        }
    });
});
</script>
<hr>
<p>
    设置选择文件夹功能, 支持选择文件夹内的所有文件.
</p>
{% endblock %}
{% block title %}
    文件夹上传示例2
{% endblock %}

知识点

1. input 元素中添加 multiple 属性, 支持多文件选择.
2. browseLabel 设置选择按钮的名称.
3. previewFileIcon 设置在文件无法识别的情况下, 显示的预览文件的图案样式.
4. allowedPreviewTypes 设置为 empty, null 或 false, 任何文件的预览功能将会关闭.
5. previewFileIconSettings 设置不同文件的预览样式.
6. previewFileExtSettings 识别不同文件格式.

本章源代码下载:

<a class=”btn btn-primary” href=”https://github.com/eastossifrage/bootstrapFileInput/archive/v1.4.zip”>zip压缩包</a>
<a class=”btn btn-primary” href=”https://github.com/eastossifrage/bootstrapFileInput/archive/v1.4.tar.gz”>tar.gz压缩包</a>