election-game/web/src/splash.ts

45 lines
1.4 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* 載入畫面(index.html 的 #splash):首頁等 3D 小鎮搭好才淡出,其他畫面一顯示就淡出。
* 首頁的主視覺用 holdSplash() 擋住,搭好或離開首頁時放開;最多擋 8 秒,免得卡在載入畫面。
*/
const MAX_MS = 8000;
let holders = 0;
const el = () => document.getElementById("splash");
export function splashProgress(text: string, fraction: number) {
const s = el();
if (!s) return;
const fill = s.querySelector<HTMLElement>(".splash-fill");
const label = s.querySelector<HTMLElement>(".splash-text");
if (fill) fill.style.width = `${Math.round(8 + Math.min(1, Math.max(0, fraction)) * 92)}%`;
if (label) label.textContent = text;
}
export function hideSplash() {
const s = el();
if (!s || s.classList.contains("is-done")) return;
s.classList.add("is-done");
window.setTimeout(() => s.remove(), 350);
}
/** 先別淡出(首頁的 3D 小鎮還在搭);回傳放開的函式 */
export function holdSplash(): () => void {
holders++;
let released = false;
return () => {
if (released) return;
released = true;
holders--;
releaseSplashIfFree();
};
}
/** 沒有人擋著就淡出(每個畫面顯示時呼叫) */
export function releaseSplashIfFree() {
// 晚一拍再看:React 開發模式會先卸載再重新掛上,中間那一下不能淡出
window.setTimeout(() => holders === 0 && hideSplash(), 0);
}
window.setTimeout(hideSplash, MAX_MS);