頁面觸發檔案下載時,若檔案偏大、伺服器需要一段時間產出,使用者往往等不住,於是狂點按鈕,最後送出一堆重複請求。解法不複雜:在下載進行中,蓋一層遮罩把頁面「鎖住」。
function lockScreen() {
sWidth = $(window).width();
sHeight = $(window).height();
var bgObj = document.createElement("div");
bgObj.setAttribute('id', 'bgDiv');
bgObj.style.position = "absolute";
bgObj.style.top = "0";
bgObj.style.background = "#CCCCCC";
bgObj.style.filter = "progid:DXImageTransform.Microsoft.Alpha(style=3,opacity=25,finishOpacity=75";
bgObj.style.opacity = "0.6";
bgObj.style.left = "0";
bgObj.style.width = sWidth + "px";
bgObj.style.height = sHeight + "px";
if (sWidth < 860) {
bgObj.style.width = "860px";
}
bgObj.style.zIndex = "10000";
document.body.appendChild(bgObj);
}
呼叫這個函式後,整頁被一層半透明遮罩蓋住,滑鼠點不到底下的元素,自然無法重複觸發。等到瀏覽器的下載對話框跳出來,再把遮罩移除即可。
問題在於,「瀏覽器跳出下載框」和「檔案確實存到使用者電腦」是兩件事。常見做法是約定一個暗號:伺服器在輸出檔案時順手寫入一個 cookie,前端則定時輪詢這個 cookie,一旦看到它出現,就代表下載流程走完了。
伺服器端(以 CGI 為例)設定 cookie:
<pre name="code" class="cpp">char *configDownloadToken = "finishedDownloadFile";
printf("Content-Type: application/octet-stream\nContent-Length: %ld\n", s.st_size);
printf("Set-Cookie:configDownloadToken=%s; path=/; \r\n", configDownloadToken);
printf("Content-Disposition: attachment; filename=\"%s\"\n", strrchr(filename, '/') + 1);
printf("Connection: close\n\n");</pre>
客戶端引入 jquery.cookie.js 外掛(記得在 HTML 中載入),再定時去撈那個 cookie:
var configDownloadCheckTimer;
$(document).ready(function () {
configDownloadCheckTimer = window.setInterval(function () {
var cookieValue = $.cookie('configDownloadToken');
if (cookieValue === "finishedDownloadFile") {
refreshPage();
finishDownload();
}
}, 1000);
});
function finishDownload() {
window.clearInterval(configDownloadCheckTimer);
$.removeCookie('configDownloadToken'); // 清掉這個 cookie 值
}
輪詢間隔 1000 毫秒是個折衷值:太頻繁會造成無謂請求,太稀疏則使用者會覺得頁面卡住太久才解鎖。
遮罩方案能擋住重複點擊,但擋不住使用者按 F5 重新整理。若後端產生檔案的成本很高,建議同時在伺服器端加上節流或身分驗證,前端攔截只能算第一道防線。