做 LigerUI 專案的時候,有一行 CSS 引用看似無害,卻能讓整個除錯流程陷入泥沼。這篇筆記記錄的就是這個小坑,給剛入門的朋友一個提醒。
很多後台模板都會在 common.css 裡放一段「頁面載入中」的動畫樣式:一個全螢幕遮罩加上旋轉的 loading 圖示,等頁面 ready 之後才淡出。線上環境看起來很體面,但在開發階段,它會變成你的敵人。
最直接的影響是,滑鼠點擊被遮罩層吃掉,你沒辦法在頁面元素上右鍵「檢查元素」,也沒辦法即時點擊觸發那些你正在追的按鈕事件。中斷點停在半路、頁面被一層看不見的東西蓋住,Firebug 或開發者工具裡改的樣式也看不出效果——因為真正決定畫面的規則藏在別處。就這樣,本來五分鐘能定位的問題,硬是耗掉半個下午。
最省事的做法是把這行引用註解掉,等要交付或要驗證載入體驗時再放回來:
<%--<link href="../lib/css/common.css" rel="stylesheet" type="text/css" />--%>
第一,載入動畫屬於「表現層」,應該和業務邏輯分離,最好能透過一個開關變數控制,而不是寫死在共用樣式裡。第二,遇到「頁面點不動」「工具看不到元素」這類怪現象,先去檢查有沒有全螢幕的遮罩層,這比翻半天程式碼有效。第三,共用資源越方便,越要清楚它替你做了什麼——把每一行 include 都當成程式碼來讀,你會少走很多彎路。