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" >zip壓縮包</a>
<a class="btn btn-primary" >tar.gz壓縮包</a>