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,就能讓你的網頁自由得多。