45 lines
1.4 KiB
TypeScript
45 lines
1.4 KiB
TypeScript
|
|
/**
|
|||
|
|
* 載入畫面(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);
|