DIV CSS 佈局教程網

自訂 Ajax 檔案上傳按鈕樣式:隱藏 file 標籤的技巧總結
編輯:AJAX基礎知識     

HTML 裡上傳檔案的標籤只有一個 <input type="file">,功能沒問題,但它的外觀實在不敢恭維,而且想改樣式還真不容易——各瀏覽器對它的渲染差異很大,直接套 CSS 幾乎改不動。

但其實有個很乾淨的解法,以下整理幾個重點。

一、怎麼自訂樣式

思路是「做一個自己喜歡的按鈕,然後讓真正的 file 輸入藏在後面」。具體兩個步驟:

先照自己喜歡的樣子定義一個元素,例如 <a href="javascript:;" class="upload-button"></a>,可以是背景圖、可以是文字,想怎麼改就怎麼改。有了按鈕之後,還要準備一個容器用來顯示「已選的檔名」,否則使用者不知道自己選了什麼。

再把真正需要上傳的 file 控制項加上 display:none,例如 <input type="file" class="hide" />。這樣一來,上傳介面有多漂亮,取決於你的想像力。

二、怎麼觸發事件

這是重點。觸發點放在自己寫的樣式元素上,而真正起作用的元素雖然是隱藏的,卻不影響它的點擊效果——只要幫它觸發一個 click 事件即可:

$('#myButton').on('click', function () {
    $('#target-file').trigger('click');
});

接著監聽 file 輸入的 change 事件,就能拿到使用者選的檔案。

三、多選檔案

多檔上傳只需在 file 標籤加上 multiple 屬性即可。若要更完整的體驗(拖拉放入、上傳進度、縮圖預覽),可以考慮 dropzone.js 或 uppy 這類現成套件;早期常見的 swfupload 則因依賴 Flash 已不適用。

四、相關套件可以怎麼選

介面美化可用 jQuery UI 或其他 UI 套件。要處理互動細節時通常會用到 Ajax:無刷新切換、非同步上傳、表單送出等。若希望網址列也能跟著變化,可用 pushState/replaceState 實作 pjax 式的體驗。

幾個常見搭配:表單驗證可用 validform.js;非同步送出檔案可用 jquery.form.js;友善的彈窗提示可用 layer.js。

五、相容性問題

做介面最麻煩也最重要的一環,就是各瀏覽器之間的差異。常見的坑包括:table 寬度的計算方式不一致;select 與 input 的顯示高度不一致;alert 彈窗樣式無法自訂;以及 files[0].size 在舊版 IE 中完全取不到(範例中因此有一段判斷 window.navigator.userAgent 的分支)。

不過要說的是,這些以 userAgent 判斷瀏覽器的做法在今天已經不建議了。更好的策略是做功能偵測:例如檢查 'FormData' in window 或 input.files !== undefined,有就擁抱新功能,沒有就走降級路徑。

六、完整示範程式碼

<a href="javascript:;" up-type-id="1" class="btn btn-default small-btn switch-upload-method">
  <span>本地上傳</span>
</a>
<a href="javascript:;" up-type-id="2" class="upload-file-instead btn btn-default small-btn switch-upload-method">
  <span>打包工具</span>
</a>

<input type="file" name="apkFiles[]" id="local-upload-real-file"
       class="upload-file-real hide" response-id="local-upload-container" multiple='true' />
<input type="file" name="apkToolFiles[]" id="apk-tool-real-file"
       class="upload-file-real hide" response-id="apk-tool-container-textarea" />

<script>
$(function () {
    var alertTitle = '系統提示:';
    var submitId = '#do-submit';

    $('#taskForm').Validform({
        btnSubmit: submitId,
        tiptype: 1,
        ignoreHidden: true,
        showAllError: false,
        postonce: true,
        ajaxPost: true,
        beforeSubmit: function (curform) {
            $('.upload-file-real').attr('disabled', 'disabled');
            $(submitId).attr('disabled', 'disabled');   // 送出前禁用按鈕
            ajaxSubmitForm(curform);
            $(submitId).removeAttr('disabled');         // 失敗後恢復可送出
            return false;
        }
    });

    // 切換上傳方式
    $('.switch-upload-method').off().on('click', function () {
        var pObj = $(this).parent().find('.switch-upload-method');
        var index = pObj.index(this);
        var uploadTypeId = $('#upload-type-id').val();
        // 上傳方式:1 打包工具;2 本地上傳;0 尚未選擇
        var uploadType = $(this).attr('up-type-id');

        if (parseInt($('#sub-channel-count').html()) > 0) {
            if (uploadTypeId != uploadType) {
                layer.alert('還有子渠道包數據,不能完成切換,請先確認清除再切換!');
                return false;
            }
        }

        pObj.not(':eq(' + index + ')').removeClass('btn-danger').addClass('btn-default');
        pObj.eq(index).removeClass('btn-default').addClass('btn-danger');

        if (uploadType == 36) {          // 本地上傳
            $('#upload-type-id').val(uploadType);
            $('#init-apk-container').show();
            $('#apk-tool-container').hide();
            $('#upload-main-control').find('.del-it-main').css({ display: 'inline-block' });
            $('#local-upload-real-file').trigger('click');   // 觸發隱藏的 file 輸入
        } else if (uploadType == 35) {   // 打包工具
            $('#upload-type-id').val(uploadType);
            $('#init-apk-container').hide();
            $('#local-upload-container').hide();
            $('#upload-main-control').find('.del-it-main').hide();
            $('#apk-tool-container').show();
        }
    });

    // 本地上傳:先檢查大小,再用 ajaxSubmit 送出
    $('#local-upload-real-file').off().on('change', function () {
        if (!$(this).val()) { return false; }

        var file_size = 0;
        var maxFileSize = 30 * 1024 * 1024;   // 30MB

        // 功能偵測:能取到 files 就用標準 API
        if (this.files && this.files[0]) {
            file_size = this.files[0].size;
            if (file_size > maxFileSize) {
                alert("上傳包超過 30MB 限制,請使用打包工具上傳!");
                return false;
            }
        } else {
            // 舊版 IE 的降級處理
            var img = new Image();
            img.src = $(this).val();
            while (img.fileSize <= 0) { /* 等待 fileSize 可用 */ }
            if (img.fileSize > maxFileSize) {
                alert("上傳包超過 30MB 限制,請使用打包工具上傳!");
                return false;
            }
        }

        var responseObj = $('#' + $(this).attr('response-id'));
        $('#taskForm').ajaxSubmit({
            url: '/aa/bb/uploadTmpApk',
            resetForm: false,
            dataType: 'json',
            beforeSubmit: function () { window.loading = layer.load(2); },
            success: function (data) {
                layer.close(window.loading);
                if (data.status == 1) {
                    $('#version-identifier').val(data.version);
                    responseObj.html(data.apkInfoHtml).show();
                    $('#upload-main-control').find('.del-it-main').css({ display: 'inline-block' });
                    $('#sub-channel-count').html(data.apkTotal);
                    $('#init-apk-container').hide();
                    $(submitId).removeAttr('disabled');
                } else {
                    layer.alert(data.info, { title: alertTitle });
                }
            },
            error: function () {
                layer.close(window.loading);
                layer.alert('未知錯誤,請稍後再試!');
            }
        });
        return false;   // 防止 dialog 自動關閉
    });

    // 打包工具上傳
    $('#apk-tool-real-file').off().on('change', function () {
        if (!$(this).val()) { return false; }

        var responseObj = $('#' + $(this).attr('response-id'));
        $('#Form').ajaxSubmit({
            url: '/aa/bb/uploadTmpApkTool',
            resetForm: false,
            dataType: 'json',
            beforeSubmit: function () { window.loading = layer.load(2); },
            success: function (data) {
                layer.close(window.loading);
                if (data.status == 1) {
                    $('#version-identifier').val(data.version);
                    responseObj.html(data.infoHtml);
                    var parentContainer = responseObj.parent().parent();
                    parentContainer.find('.apk-name-container')
                        .html(data.apkName).attr('title', data.apkName);
                    $('#apk-tool-file-tmp').html(data.fileInfo);
                    $(submitId).removeAttr('disabled');
                } else {
                    layer.alert(data.info, { title: alertTitle });
                }
            },
            error: function () {
                layer.close(window.loading);
                layer.alert('未知錯誤,請稍後再試!');
            }
        });
        return false;
    });

    $('.apk-tool-upload-button').on('click', function () {
        $('#apk-tool-real-file').trigger('click');
    });
});
</script>

整體流程回顧

整套機制的骨架其實只有三步:用隱藏的 input type="file" 負責真正的選檔;使用者點擊自訂按鈕時觸發它的 click;選好檔案後立刻以 Ajax 送出,最後再由整個表單統一提交。

如果今天可以用原生寫法,FormData 搭配 fetch 就能取代 jquery.form.js 的大部分工作,程式碼會更短也更透明:

$('#myForm').on('submit', function (e) {
    e.preventDefault();
    var fd = new FormData(this);          // 自動包含 file 欄位
    fetch('/upload', { method: 'POST', body: fd })
        .then(r => r.json())
        .then(data => console.log(data))
        .catch(err => alert('上傳失敗:' + err));
});

最後提醒一個務必在後端做對的事:副檔名與 MIME 型別只能當參考,不能當驗證。使用者可以輕易竄改檔名與標頭,因此伺服器端必須檢查檔案的實際內容(例如用 magic number 判斷),限制檔案大小,並把上傳檔案存到 Web 根目錄之外、以不可執行的權限存放,檔名則改用重新產生的隨機名稱,避免覆蓋既有檔案或造成路徑穿越。

合理使用一些 CSS 與 JS,就能讓你的網頁自由得多。

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