DIV CSS 佈局教程網

Bootstrap 檔案上傳樣式四款比較:手寫、filestyle、file-input 到 Fine Uploader
編輯:關於JavaScript     

原生的檔案選擇框長相由瀏覽器決定,放進 Bootstrap 版面裡格外突兀。這篇整理四種改善方案,從零成本手寫到功能完整的上傳器,各有適用場景。

方案一:純手寫,零依賴

思路是把真正的 file input 藏起來,另做一個文字框和一個按鈕,點按鈕時觸發隱藏 input 的點擊,選完檔再把檔名填進文字框。只需要 Bootstrap 與 jQuery:

<input id="lefile" type="file" style="display:none">
<div class="input-append">
  <input id="photoCover" class="input-large" type="text" style="height:30px;">
  <a class="btn" onclick="$('input[id=lefile]').click();">Browse</a>
</div>
<script type="text/javascript">
$('input[id=lefile]').change(function() {
    $('#photoCover').val($(this).val());
});
</script>

沒有任何額外 JS 與 CSS,本質上就是用版面拼一個假的輸入框,再用 change 事件把檔名同步過去。

方案二:bootstrap-filestyle

專案頁:https://markusslima.github.io/bootstrap-filestyle/

要注意版本相容性:這個樣式只吃 Bootstrap 2 的 CSS,用在 Bootstrap 3 上會跑掉。當初就是在這裡卡了很久才發現問題。

方案三:bootstrap-file-input

展示頁:https://www.gregpike.net/demos/bootstrap-file-input/demo.html

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>bootstrap.file-input</title>
<link href="css/bootstrap.min.css" rel="stylesheet" />
<script src="js/jquery-2.0.3.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="js/bootstrap.file-input.js"></script>
</head>
<body>
<!-- 用 title 屬性就能改按鈕文字 -->
<input type="file" title="Search for a file to add 1" class="btn-primary">
<input type="file" title="Search for a file to add 2" class="btn btn-primary">
<input type="file" title="Search for a file to add 3" class="btn-primary">

<!-- 加上 data-bfi-disabled 就能停用樣式 -->
<input type="file" data-bfi-disabled>

<script type="text/javascript">
$('input[type=file]').bootstrapFileInput();
</script>
</body>
</html>

直接引入後會發現找不到 bootstrapFileInput 這個方法。解法是打開 bootstrap.file-input.js,把外層的 IIFE 包裝(也就是最開頭那一行)移除,讓 $.fn.bootstrapFileInput 直接掛在全域:

/* 把原本最外層的 (function($){ ... })(jQuery); 拆掉,直接這樣定義 */
$.fn.bootstrapFileInput = function () {
    this.each(function (i, elem) {
        // ……中間邏輯保持不變

        // 樣式在執行期動態插入到第一個 stylesheet 之前,
        // 這樣開發者要覆寫就相對容易
        var cssHtml = '<style>'
            + '.file-input-wrapper { overflow: hidden; position: relative; cursor: pointer; z-index: 1; }'
            + '.file-input-wrapper input[type=file],'
            + ' .file-input-wrapper input[type=file]:focus,'
            + ' .file-input-wrapper input[type=file]:hover {'
            + '   position: absolute; top: 0; left: 0; cursor: pointer;'
            + '   opacity: 0; filter: alpha(opacity=0); z-index: 99; outline: 0; }'
            + '.file-input-name { margin-left: 8px; }'
            + '</style>';
        $('link[rel=stylesheet]').eq(0).before(cssHtml);
    });
};

方案四:Fine Uploader

官網 https://fineuploader.com/demos.html 的正式下載是付費的,社群上有開源版本可以取用。解壓後目錄如下:

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Fine Uploader Demo</title>
<link href="css/bootstrap.min.css" rel="stylesheet" />
<link href="css/fineuploader.css" rel="stylesheet" />
<script src="js/jquery-2.0.3.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="js/all.fineuploader-4.3.1.min.js"></script>
</head>
<body>

<!-- 手動模式:先選檔,再按鈕才上傳 -->
<div id="manual-fine-uploader"></div>
<div id="triggerUpload" class="btn btn-primary" style="margin-top: 10px;">
  <i class="icon-upload icon-white"></i> Upload now
</div>

<!-- 自動模式 -->
<div id="fine-uploader"></div>

<!-- 這個 template 一定要存在,否則 console 會直接報錯 -->
<script type="text/template" id="qq-template">
<div class="qq-uploader-selector qq-uploader">
  <div class="qq-upload-drop-area-selector qq-upload-drop-area" qq-hide-dropzone>
    <span>Drop files here to upload</span>
  </div>
  <div class="qq-upload-button-selector qq-upload-button">
    <div>Upload a file</div>
  </div>
  <span class="qq-drop-processing-selector qq-drop-processing">
    <span>Processing dropped files...</span>
    <span class="qq-drop-processing-spinner-selector qq-drop-processing-spinner"></span>
  </span>
  <ul class="qq-upload-list-selector qq-upload-list">
    <li>
      <div class="qq-progress-bar-container-selector">
        <div class="qq-progress-bar-selector qq-progress-bar"></div>
      </div>
      <span class="qq-upload-spinner-selector qq-upload-spinner"></span>
      <span class="qq-edit-filename-icon-selector qq-edit-filename-icon"></span>
      <span class="qq-upload-file-selector qq-upload-file"></span>
      <input class="qq-edit-filename-selector qq-edit-filename" tabindex="0" type="text">
      <span class="qq-upload-size-selector qq-upload-size"></span>
      <a class="qq-upload-cancel-selector qq-upload-cancel" href="#">Cancel</a>
      <a class="qq-upload-retry-selector qq-upload-retry" href="#">Retry</a>
      <a class="qq-upload-delete-selector qq-upload-delete" href="#">Delete</a>
      <span class="qq-upload-status-text-selector qq-upload-status-text"></span>
    </li>
  </ul>
</div>
</script>

<script>
$(document).ready(function () {
    var manualuploader = $('#manual-fine-uploader').fineUploader({
        request: { endpoint: 'server/handleUploads' },
        autoUpload: false,
        text: { uploadButton: '<i class="icon-plus icon-white"</i> Select Files' }
    });
    $('#triggerUpload').click(function () {
        manualuploader.fineUploader('uploadStoredFiles');
    });

    $('#fine-uploader').fineUploader({
        request: { endpoint: 'server/handleUploads' }
    });
});
</script>
</body>
</html>

CSS 與一般 JS 在解壓目錄裡都找得到,只有 all.fineuploader-4.3.1.min.js 不在其中,可以從官網的展示頁用開發者工具另存。

最關鍵的一點是那段 #qq-template。少了它,console 會直接拋錯:

原因寫在官方說明裡:

Fine Uploader 4.x 把 UI 完全抽成模板,必須提供模板節點才能運作。

(圖中樣式較素,是因為沒有載入對應的主題圖片。)

怎麼選

只是要讓按鈕看起來正常,方案一十分鐘搞定,也不必多載任何檔案。想要有檔名顯示與基礎樣式,方案三改一改就能用。真的需要拖拉、續傳、進度條、檔案縮圖這些完整能力,才值得引入 Fine Uploader 這類完整方案——但要先確認後端能配合它的協定。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved