寫給剛入門的朋友一個小提醒:LigerUi 專案裡那行引入 common.css 的語法,在開發階段最好先註解掉。
<%--<link href="../lib/css/common.css" rel="stylesheet" type="text/css" />--%>
這個樣式表的作用是讓頁面在載入時顯示一個「正在載入」的轉圈動畫效果。問題在於它會蓋住整個頁面的內容,直到載入流程結束才消失。
對終端使用者來說這是好事——等待時有明確回饋。但對開發者來說,它會嚴重干擾除錯:你想用 Firebug 或開發者工具檢查某個元素的樣式、想看一下後端回傳的內容、想在斷點處停下來慢慢看,那層遮罩永遠擋在中間。更麻煩的是,若載入流程本身出錯,遮罩不會消失,你連錯誤訊息都看不到。
建議在正式上線前才把註解解除,日常開發一律關閉。如果擔心忘記,可以搭配建置流程或環境變數控制,讓開發環境自動排除這行,正式環境自動帶入。
這類「為了使用者體驗而存在、卻妨礙開發效率」的設計在框架裡很常見。與其花好幾個小時去搞清楚為什麼頁面永遠是灰的,不如一開始就知道有這麼一個開關。新手容易在這上面栽跟頭,謹記。